213 research outputs found
Appendix for "Properties and Styles of Software Technology Tutorials"
<p>This artifact contains details of the resource collection, analysis scripts, and data analyzed in the paper "Properties and Styles of Software Technology Tutorials" by Deeksha M. Arya, Jin L.C. Guo, and Martin P. Robillard.</p>
Data from: Understanding Test Convention Consistency as a Dimension of Test Quality
<div>
<div>This archive provides additional data for the article "Understanding Test Convention Consistency</div>
<div>as a Dimension of Test Quality" by Martin P. Robillard, Mathieu Nassif, and Muhammad Sohail,</div>
<div>published in ACM Transactions on Software Engineering and Methodology.</div>
</div>
Benchmarking: A Methodology for Ensuring the Relative Quality of Recommendation Systems in Software Engineering
Platybinthus sandyi Robillard & Tan 2022, gen. et sp. nov.
Platybinthus sandyi gen. et sp. nov. urn:lsid:zoobank.org:act: 90D41D87-CFAD-4C8F-A623-47529A073E43 Figs 3, 4E–H, 5C, F, 6C, 7B, D, 8D–F Diagnosis This new species differs from Platybinthus striolatus gen. et comb. nov. by its larger size and by male genitalia with pseudepiphallus with dorsal disk larger, apical margins straight and parallel and by pseudepiphallic parameres with ventral lobe appearing triangular and flattened. Etymology This species is dedicated to Sandy Robillard, the late brother of the first author. Material examined Holotype INDONESIA • ♂; [Maluku] Sangi en Talaud, Goegoeti [Indonesia: Maluku, Morotai, Pilowo, Guguti (2°6′3.63″ N, 128°15′36.83″ E)]; Jun. 1926; Erie leg.; molecular sample L163; GenBank accession: OP684787 and OP686540; MZB.ORTH.1786. Paratypes INDONESIA • 1 ♀; same collection data as for holotype; MZB.ORTH.1787 • 1 ♀; same collection data as for holotype; MZB.ORTH.1788 • 1 ♂; Morotai, Goegoeti [Maluku, Morotai, Pilowo, Guguti (2°6′3.63″ N, 128°15′36.83″ E)]; 1926; Erie leg. (ex MZB.ORTH.1839); MNHN-EO-ENSIF11342. Remark The labels of all the type specimens mention “Sangi en Talaud”, seemingly referring to the archipelago of Sangi and Talaud, near northern Sulawesi. However, the manuscript addition of the term Goegoeti on the labels of all the specimens of the type series, completed with the term “Morotai” on the label of one male specimen, suggests that the type locality may rather correspond to the locality of Pilowo, Goegoeti (Guguti) (2°6′3.63″ N, 128°15′36.83″ E), in the island of Morotai, Maluku. Description Size relatively large for the genus (Fig. 4E–H). Vertex and fastigium brown, lighter in colouration than P. punctatus gen. et comb. nov. (Fig. 5C); back of eyes with a cream-coloured band. Scapes brown. Antennae orange brown. Fastigium verticis and frons brown to dark brown (Fig. 5F). Mandibles mostly brown; clypeus brown with some dark patterns, labrum pale yellow with two dark longitudinal stripes in the middle; maxillary palpi with segments white with some dark stripes (more prominent on external surface) (Fig. 5F). Gena dark brown with a triangular white spot beneath eyes and two small white spots nearer to mouthparts. Lateral parts of head dark brown behind eyes (Fig. 6C). Pronotum dorsal disk yellow mottled with dark brown, anterior and posterior margins straight; lateral lobes very dark brown (Fig. 6C). Legs: FI–II pale with numerous dark brown spots and incomplete ring near apices, knee area dark brown; TI–II pale with three broad dark brown rings; tarsomeres 1 and 3 of each leg yellow basally then dark brown; FIII brown finely mottled with yellow and dark brown, knees dark brown; TIII brown to dark brown, spurs lighter brown with dark tips. Abdominal tergites dark brown with faint dark and light spots. Cerci brown with faint apical rings. Male FW surpassing base of third tergite. FW colouration (Fig. 7B): dorsal field cells mostly yellow brown, with two faint pale spots at the basal and apical end of Cu and M; veins pale brown; M yellow brown, R red brown. Lateral field cells dark brown and whitish near ventral margin; longitudinal veins red brown. FW venation: harp vein bordering false mirror strongly sinuous, slightly angular. Anal area of dorsal field not extending beyond apex of lateral field, apex of dorsal field truncated. GENITALIA (Fig. 8D–F). Pseudepiphallus typical of genus, except dorsal disk larger, posterior apex truncated, lateral margins at the apex straight and parallel. Rami shorter. Pseudepiphallic parameres with ventral lobe appearing triangular and flattened. Endophallic sclerite with long anterior region reaching anterior margin of pseudepiphallic sclerite and a short median expansion and small lateral arms posteriorly. Endophallic apodeme with lateral lamellae pointing laterally. Female FWs reaching middle of fourth tergite, faintly overlapping. Cells of dorsal field dark brown, not translucent, with strong orange longitudinal veins and weak yellow transverse ones; with 9 veins on dorsal field, 4 on lateral field (Fig. 7D). Dorsal field apex truncated, lateral field posterior margin oblique. GENITALIA. Ovipositor as long as FIII, apex very slightly denticulate dorsally. Copulatory papilla not observed (lost in female specimen). Measurements See Table 1. Ecology Unknown. Distribution INDONESIA: Morotai Island near northern Halmahera. Type locality INDONESIA: Morotai Island, near northern Halmahera (see remarks). Calling song Unknown.Published as part of Robillard, Tony & Tan, Ming Kai, 2023, Platybinthus, a new genus of Lebinthina crickets (Orthoptera, Gryllidae, Eneopterinae) from Maluka, Indonesia, pp. 46-66 in European Journal of Taxonomy 856 (1) on pages 61-62, DOI: 10.5852/ejt.2023.856.2027, http://zenodo.org/record/754431
Understanding Wikipedia as a Resource for Opportunistic Learning of Computing Concepts
Posts on on-line forums where programmers look for information often include links to Wikipedia when it can be assumed the reader will not be familiar with the linked terms. A Wikipedia article will thus often be the first exposure to a new computing concept for a novice programmer. We conducted an exploratory study with 18 novice programmers by asking them to read a Wikipedia article on a common computing concept that was new to them, while using the think-aloud protocol.We performed a qualitative analysis of the session transcripts to better understand the experience of the novice programmer learning a new computing concept using Wikipedia. We elicited five themes that capture this experience: Concept Confusion, Need for Examples, New Terminology, Trivia Clutter, and Unfamiliar Notation. We conclude that Wikipedia is not well suited as a resource for the opportunistic learning of new computing concepts, and we recommend adapting information sharing practices in on-line programmer communities to better account for the learning needs of the users.Martin P. Robillard, Christoph Treud
Extracting development tasks to navigate software documentation
Knowledge management plays a central role in many software development organizations. While much of the important technical knowledge can be captured in documentation, there often exists a gap between the information needs of software developers and the documentation structure. To help developers navigate documentation, we developed a technique for automatically extracting tasks from software documentation by conceptualizing tasks as specific programming actions that have been described in the documentation. More than 70 percent of the tasks we extracted from the documentation of two projects were judged meaningful by at least one of two developers. We present TaskNavigator, a user interface for search queries that suggests tasks extracted with our technique in an auto-complete list along with concepts, code elements, and section headers. We conducted a field study in which six professional developers used TaskNavigator for two weeks as part of their ongoing work. We found search results identified through extracted tasks to be more helpful to developers than those found through concepts, code elements, and section headers. The results indicate that task descriptions can be effectively extracted from software documentation, and that they help bridge the gap between documentation structure and the information needs of software developers.Christoph Treude, Martin P. Robillard, and Barthélémy Dagenai
Augmenting API documentation with insights from Stack Overflow
Software developers need access to different kinds of information which is often dispersed among different documentation sources, such as API documentation or Stack Overflow. We present an approach to automatically augment API documentation with "insight sentences" from Stack Overflow- sentences that are related to a particular API type and that provide insight not contained in the API documentation of that type. Based on a development set of 1,574 sentences, we compare the performance of two state-of-the-art summarization techniques as well as a pattern-based approach for insight sentence extraction. We then present SISE, a novel machine learning based approach that uses as features the sentences themselves, their formatting, their question, their answer, and their authors as well as part-of-speech tags and the similarity of a sentence to the corresponding API documentation. With SISE, we were able to achieve a precision of 0.64 and a coverage of 0.7 on the development set. In a comparative study with eight software developers, we found that SISE resulted in the highest number of sentences that were considered to add useful information not found in the API documentation. These results indicate that taking into account the meta data available on Stack Overflow as well as part-of-speech tags can significantly improve unsupervised extraction approaches when applied to Stack Overflow data.Christoph Treude, Martin P. Robillar
Reuse-Oriented Code Recommendation Systems
Effective software reuse has long been regarded as an important foundation for a more engineering-like approach to software development. Proactive recommendation systems that have the ability to unobtrusively suggest immediately applicable reuse opportunities can become a crucial step toward realizing this goal and making reuse more practical. This chapter focuses on tools that support reuse through the recommendation of source code—reuse-oriented code recommendation systems (ROCR). These support a large variety of common code reuse approaches from the copy-and-paste metaphor to other techniques such as automatically generating code using the knowledge gained by mining source code repositories. In this chapter, we discuss the foundations of software search and reuse, provide an overview of the main characteristics of ROCR systems, and describe how they can be built
Communicating Study Design Trade-offs in Software Engineering
Reflecting on the limitations of a study is a crucial part of the research process. In software engineering studies, this reflection is typically conveyed through discussions of study limitations or threats to validity. In current practice, such discussions seldom provide sufficient insight to understand the rationale for decisions taken before and during the study, and their implications. We revisit the practice of discussing study limitations and threats to validity and identify its weaknesses. We propose to refocus this practice of self-reflection to a discussion centered on the notion of trade-offs. We argue that documenting trade-offs allows researchers to clarify how the benefits of their study design decisions outweigh the costs of possible alternatives. We present guidelines for reporting trade-offs in a way that promotes a fair and dispassionate assessment of researchers’ work
Literacy and the vernacular : a case study based on the post-colonial history of Mauritius, with particular reference to Mauritian Creole
This thesis examines the process of the literization of the vernacular, and seeks to establish the island of Mauritius as a case study of this process. The concept of literization equates standardization of the vernacular with its use as a written language. Four issues are established as central to this process: ideological, educational, sociocultural and technical.
The thesis investigates the particular sociolinguistic situation of Mauritius, and examines each of these issues in relation to Mauritian Creole. It demonstrates the role that Mauritian Creole plays in Mauritian society, and how, since independence, issues relating to ideology, education, and the cultural and technical aspects of standardization, have been involved in the promotion of the language. The interaction between these issues is apparent throughout the thesis, and manifested in the work of Ledikasyon pu Travayer (LPT), the only organization in Mauritius to provide literacy tuition in Mauritian Creole. The thesis seeks to show that their unified approach to literacy, standardization, and the promotion of Mauritian Creole exemplifies the issues involved, and provides the best basis for the establishment of Mauritian Creole as a standard language.
The analysis of the situation in Mauritius within the framework of wider issues of the literization of the vernacular permits a comparison to other former colonies facing problems of language choice, and places these issues within the wider sociolinguistic context of standardization
- …
