Write a Blog >>
ICSE 2020
Wed 24 June - Thu 16 July 2020
Thu 9 Jul 2020 08:05 - 08:13 at Silla - I18-APIs and Commits Chair(s): Massimiliano Di Penta

As one key resource to learn Application Programming Interfaces (APIs), a lot of API reference documentation lacks code samples with usage scenarios, thus heavily hindering developers from programming with APIs. Although researchers have investigated how to enrich API documentation with code samples from general code search engines, two main challenges remain to be resolved, including the quality challenge of acquiring high-quality code samples and the mapping challenge of matching code samples to usage scenarios. In this study, we propose a novel approach named ADECK towards enriching API documentation with code samples and corresponding usage scenarios by leveraging crowd knowledge from Stack Overflow, a popular technical Question and Answer (Q&A) website attracting millions of developers. Given an API related Q&A pair, a code sample in the answer is extensively evaluated by developers and targeted towards resolving the question under the specified usage scenario. Hence, ADECK can obtain high-quality code samples and map them to corresponding usage scenarios to address the above challenges. Extensive experiments on the Java SE and Android API documentation show that the number of code-sample-illustrated API types in the ADECK-enriched API documentation is 3.35 and 5.76 times as many as that in the raw API documentation. Meanwhile, the quality of code samples obtained by ADECK is better than that of code samples by the baseline approach eXoaDocs in terms of correctness, conciseness, and usability, e.g., the average correctness values of representative code samples obtained by ADECK and eXoaDocs are 4.26 and 3.28 on a 5-point scale in the enriched Java SE API documentation. In addition, an empirical study investigating the impacts of different types of API documentation on the productivity of developers shows that, compared against the raw and the eXoaDocs-enriched API documentation, the ADECK-enriched API documentation can help developers complete 23.81% and 14.29% more programming tasks and reduce the average completion time by 9.43% and 11.03%.

Thu 9 Jul
Times are displayed in time zone: (UTC) Coordinated Universal Time change

08:05 - 09:05: I18-APIs and CommitsPaper Presentations / New Ideas and Emerging Results / Journal First / Technical Papers at Silla
Chair(s): Massimiliano Di PentaUniversity of Sannio
08:05 - 08:13
Talk
Journal First
Jingxuan ZhangNanjing University of Aeronautics and Astronautics, He JiangSchool of Software, Dalian University of Technology, Zhilei RenDalian University of Technology, Tao ZhangHarbin Engineering University, Zhiqiu HuangNanjing University of Aeronautics and Astronautics
08:13 - 08:19
Talk
New Ideas and Emerging Results
Sebastian NielebockOtto-von-Guericke University Magdeburg, Germany, Robert HeumüllerChair of Software Engineering, Faculty of Computer Science, Otto-von-Guericke-University Magdeburg, Jacob KrügerOtto von Guericke University Magdeburg, Frank OrtmeierOtto-von-Guericke-University Magdeburg, Faculty of Computer Science, Chair of Software Engineering
DOI Pre-print
08:19 - 08:31
Talk
Technical Papers
Hao XiaFudan University, Yuan ZhangFudan University, Yingtian ZhouFudan University, Xiaoting ChenFudan University, Yang WangFudan University, Xiangyu ZhangPurdue University, Shuaishuai CuiFudan University, Geng HongFudan University, Xiaohan ZhangFudan University, Min YangFudan University, Zhemin YangFudan University
08:31 - 08:43
Talk
Technical Papers
Hao ZhongShanghai Jiao Tong University, Na MengVirginia Tech, Zexuan LiShanghai Jiao Tong University, Li JiaShanghai Jiao Tong University
08:43 - 08:49
Talk
New Ideas and Emerging Results
Ming WenHuazhong University of Science and Technology, China, Yepang LiuSouthern University of Science and Technology, Shing-Chi CheungDepartment of Computer Science and Engineering, The Hong Kong University of Science and Technology
08:49 - 09:01
Talk
Technical Papers
Emad AghajaniSoftware Institute, USI - Lugano, Switzerland, Csaba NagySoftware Institute - USI, Lugano, Switzerland, Mario Linares-VásquezUniversidad de los Andes, Laura MorenoColorado State University, Gabriele BavotaUniversità della Svizzera italiana, Michele LanzaUniversita della Svizzera italiana (USI), David C. ShepherdVirginia Commonwealth University
Pre-print Media Attached