Automatic Detection and Update Suggestion for Outdated API Names in Documentation
- Authors
- Lee, Seonah; Wu, Rongxin; Cheung, Shing-Chi; Kang, 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
Items in ScholarWorks are protected by copyright, with all rights reserved, unless otherwise indicated.