Assessing Comment Quality in Object-Oriented Languages - Couverture souple

Rani, Pooja

Couverture souple

ISBN 10 : 1678175722 ISBN 13 : 9781678175726

Editeur : Lulu.com, 2022

Synopsis

High-quality code comments support developers in software maintenance and program comprehension tasks. However, the semi-structured nature of comments, several conventions to write comments, and the lack of quality assessment tools for all aspects of comments make comment evaluation and maintenance a non-trivial problem. To understand the specification of high-quality comments to build effective assessment tools, we emphasize on acquiring a multi-perspective view of the comments, which can be approached by analyzing (1) the academic support for comment quality assessment, (2) developer commenting practices across languages, and (3) developer concerns about comments. To help researchers and developers in building comment quality assessment tools, we contribute: (i) a systematic literature review (SLR) of ten years (2010–2020) of research on assessing comment quality, (ii) a taxonomy of comment quality attributes, (iii) an empirically validated taxonomy of class comment information types (CITs) from three programming languages, (iv) a multi-programming-language approach to automatically identify the CITs, and (v) an empirically validated taxonomy of comment convention-related questions and recommendation from various Q&A forums. Our contributions provide various kinds of empirical evidence of the developer’s interest in reducing efforts in the software documentation process, of the limited support developers get in automatically assessing comment quality, and of the challenges they face in writing high-quality comments.

Détails de l'édition

• Éditeur: Lulu.com
• Date d'édition: 2022
• Langue: anglais
• ISBN 10: 1678175722
• ISBN 13: 9781678175726
• Reliure: Broché
• Nombre de pages: 195
• Coordonnées du fabricant: non disponible
• Personne responsable: HACHETTE LIVRE SA; https://www.hachette.fr/; ; 1 AVENUE GUTENBERG; MAUREPAS CEDEX; 78319; France