Write a Blog >>
Fri 13 Nov 2020 01:33 - 01:34 at Virtual room 1 - Documentation

Software engineering is knowledge-intensive and requires software developers to continually search for knowledge, often on community question answering platforms such as Stack Overflow. Such information sharing platforms do not exist in isolation, and part of the evidence that they exist in a broader software documentation ecosystem is the common presence of hyperlinks to other documentation resources found in forum posts. With the goal of helping to improve the information diffusion between Stack Overflow and other documentation resources, we conducted a study to answer the question of how and why documentation is referenced in Stack Overflow threads. We sampled and classified 759 links from two different domains, regular expressions and Android development, to qualitatively and quantitatively analyze the links’ context and purpose, including attribution, awareness, and recommendations. We found that links on Stack Overflow serve a wide range of distinct purposes, ranging from citation links attributing content copied into Stack Overflow, over links clarifying concepts using Wikipedia pages, to recommendations of software components and resources for background reading. This purpose spectrum has major corollaries, including our observation that links to documentation resources are a reflection of the information needs typical to a technology domain. We contribute a framework and method to analyze the context and purpose of Stack Overflow links, a public dataset of annotated links, and a description of five major observations about linking practices on Stack Overflow. Those observations include the above-mentioned purpose spectrum, its interplay with documentation resources and applications domains, and the fact that links on Stack Overflow often lack context in form of accompanying quotes or summaries. We further point to potential tool support to enhance the information diffusion between Stack Overflow and other documentation resources.

Fri 13 Nov

Displayed time zone: (UTC) Coordinated Universal Time change

01:30 - 02:00
01:30
2m
Talk
Beyond Accuracy: Assessing Software Documentation Quality
Visions and Reflections
Christoph Treude University of Adelaide, Australia, Justin Middleton North Carolina State University, USA, Thushari Atapattu The University of Adelaide
DOI
01:33
1m
Talk
Contextual Documentation Referencing on Stack Overflow
Journal First
Sebastian Baltes QAware GmbH and The University of Adelaide, Christoph Treude University of Adelaide, Australia, Martin P. Robillard McGill University
Pre-print
01:35
1m
Talk
DeepCommenter: A Deep Code Comment Generation Tool with Hybrid Lexical and Syntactical Information
Tool Demos
Boao Li Zhejiang University, China, Meng Yan Chongqing University, Xin Xia Monash University, Xing Hu Peking University, Ge Li Peking University, David Lo Singapore Management University
DOI
01:37
1m
Talk
Docable: Evaluating the Executability of Software Tutorials
Research Papers
Samim Mirhosseini North Carolina State University, USA, Chris Parnin North Carolina State University, USA
DOI Pre-print
01:39
1m
Talk
RulePad: Interactive Authoring of Checkable Design Rules
Research Papers
Sahar Mehrpour George Mason University, USA, Thomas LaToza George Mason University, USA, Hamed Sarvari George Mason University, USA
DOI Pre-print
01:41
1m
Talk
Software Documentation and Augmented Reality: Love or Arranged Marriage?
Visions and Reflections
Sridhar Chimalakonda Indian Institute of Technology Tirupati, Akhila Sri Manasa Venigalla IIT Tirupati, India
DOI
01:43
17m
Talk
Conversations on Documentation
Paper Presentations
Akhila Sri Manasa Venigalla , Christoph Treude University of Adelaide, Australia, Sahar Mehrpour George Mason University, USA, Samim Mirhosseini North Carolina State University, USA, Sridhar Chimalakonda Indian Institute of Technology Tirupati, M: Venera Arnaoudova Washington State University