Abstract
Programmers need documentation to comprehend software, but they often lack the time to write it. Thus, programmers must prioritize their documentation effort to ensure that sections of code important to program comprehension are thoroughly explained. In this paper, we explore the possibility of automatically prioritizing documentation effort. We performed two user studies to evaluate the effectiveness of static source code attributes and textual analysis of source code towards prioritizing documentation effort. The first study used open-source API Libraries while the second study was conducted using closed-source industrial software from ABB. Our findings suggest that static source code attributes are poor predictors of documentation effort priority, whereas textual analysis of source code consistently performed well as a predictor of documentation effort priority.
Publication Date
2018
Document Type
Article
Department, Program, or Center
Software Engineering (GCCIS)
Recommended Citation
P. W. McBurney et al., "Towards Prioritizing Documentation Effort," in IEEE Transactions on Software Engineering, vol. 44, no. 9, pp. 897-913, 1 Sept. 2018, doi: 10.1109/TSE.2017.2716950.
Campus
RIT – Main Campus
Comments
© 2017 IEEE. Personal use of this material is permitted. Permission from IEEE must be obtained for all other uses, in any current or future media, including reprinting/republishing this material for advertising or promotional purposes, creating new collective works, for resale or redistribution to servers or lists, or reuse of any copyrighted component of this work in other works.
DOI: 10.1109/TSE.2017.2716950