Conference paper
Improving API Caveats Accessibility by Mining API Caveats Knowledge Graph
The International Conference on Software Maintenance and Evolution (ICSME) (Madrid, Spain, 23/09/2018–29/09/2018)
09/2023
Abstract
API documentation provides important knowledge about the functionality and usage of APIs. In this paper, we focus on API caveats that developers should be aware of in order to avoid unintended use of an API. Our formative study of Stack Overflow questions suggests that API caveats are often scattered in multiple API documents, and are buried in lengthy textual descriptions. These characteristics make the API caveats less discoverable. When developers fail to notice API caveats, it is very likely to cause some unexpected programming errors. In this paper, we propose natural language processing(NLP) techniques to extract ten subcategories of API caveat sentences from API documentation and link these sentences to API entities in an API caveats knowledge graph. The API caveats knowledge graph can support information retrieval based or entity-centric search of API caveats. As a proof-of-concept, we construct an API caveats knowledge graph for Android APIs from the API documentation on the Android Developers website. We study the abundance of different subcategories of API caveats and use a sampling method to manually evaluate the quality of the API caveats knowledge graph. We also conduct a user study to validate whether and how the API caveats knowledge graph may improve the accessibility of API caveats in API documentation.
Details
- Title
- Improving API Caveats Accessibility by Mining API Caveats Knowledge Graph
- Authors/Creators
- Hongwei Li - Jiangxi Normal UniversitySirui Li - Australian National UniversityJiamou Sun - Australian National UniversityZhenchang Xing - Australian National UniversityXin Peng - Fudan UniversityMingwei Liu - Fudan UniversityXuejiao Zhao - Nanyang Technological University
- Conference
- The International Conference on Software Maintenance and Evolution (ICSME) (Madrid, Spain, 23/09/2018–29/09/2018)
- Number of pages
- 11
- Identifiers
- 991005693764507891
- Murdoch Affiliation
- School of Information Technology
- Language
- English
- Resource Type
- Conference paper
Metrics
97 File views/ downloads
48 Record Views