Detailed Information

Cited 8 time in webofscience Cited 11 time in scopus
Metadata Downloads

Automatic Detection and Update Suggestion for Outdated API Names in Documentation

Authors
Lee, SeonahWu, RongxinCheung, Shing-ChiKang, Sungwon
Issue Date
1-Apr-2021
Publisher
Institute of Electrical and Electronics Engineers
Keywords
Documentation; Computer bugs; Tools; History; Libraries; Software systems; Application programming interfaces; documentation; history; software maintenance
Citation
IEEE Transactions on Software Engineering, v.47, no.4, pp 653 - 675
Pages
23
Indexed
SCIE
SCOPUS
Journal Title
IEEE Transactions on Software Engineering
Volume
47
Number
4
Start Page
653
End Page
675
URI
https://scholarworks.gnu.ac.kr/handle/sw.gnu/3864
DOI
10.1109/TSE.2019.2901459
ISSN
0098-5589
1939-3520
Abstract
Application programming interfaces (APIs) continually evolve to meet ever-changing user needs, and documentation provides an authoritative reference for their usage. However, API documentation is commonly outdated because nearly all of the associated updates are performed manually. Such outdated documentation, especially with regard to API names, causes major software development issues. In this paper, we propose a method for automatically updating outdated API names in API documentation. Our insight is that API updates in documentation can be derived from API implementation changes between code revisions. To evaluate the proposed method, we applied it to four open source projects. Our evaluation results show that our method, FreshDoc, detects outdated API names in API documentation with 48 percent higher accuracy than the existing state-of-the-art methods do. Moreover, when we checked the updates suggested by FreshDoc against the developers' manual updates in the revised documentation, FreshDoc detected 82 percent of the outdated names. When we reported 40 outdated API names found by FreshDoc via issue tracking systems, developers accepted 75 percent of the suggestions. These evaluation results indicate that FreshDoc can be used as a practical method for the detection and updating of API names in the associated documentation.
Files in This Item
There are no files associated with this item.
Appears in
Collections
공과대학 > Department of Aerospace and Software Engineering > Journal Articles

qrcode

Items in ScholarWorks are protected by copyright, with all rights reserved, unless otherwise indicated.

Related Researcher

Researcher Lee, Seon Ah photo

Lee, Seon Ah
IT공과대학 (소프트웨어공학과)
Read more

Altmetrics

Total Views & Downloads

BROWSE