Login | Register

Assessing The Quality Factors Found in In-Line Documentation Written in Natural Language: The JavadocMiner

Title:

Assessing The Quality Factors Found in In-Line Documentation Written in Natural Language: The JavadocMiner

Khamis, Ninus (2011) Assessing The Quality Factors Found in In-Line Documentation Written in Natural Language: The JavadocMiner. Masters thesis, Concordia University.

This is the latest version of this item.

[thumbnail of Khamis_MASc_S2011.pdf]
Preview
Text (application/pdf)
Khamis_MASc_S2011.pdf - Accepted Version
Available under License Creative Commons Attribution.
2MB

Abstract

An important software engineering artifact used by
developers and maintainers to assist in software comprehension and maintenance is source code documentation. It provides the insight needed by software engineers when performing a task, and therefore ensuring the quality of documentation is extremely important. In-line documentation is at the forefront of explaining a programmer's original intentions for a given implementation. Since this documentation is written in informal natural language, ensuring its quality needs to be performed manually. In this works, we present an effective and automated approach for assessing the quality of in-line documentation using a set of heuristics, targeting both the quality of language and consistency between source code and its comments. Our evaluation is made up of three parts: We first apply the JavadocMiner tool to the different modules of two
open source applications (ArgoUML and Eclipse) in order to
automatically assess their intrinsic comment quality. In the
second part of our evaluation, we correlate the results
returned by the analysis with bug defects reported for the
individual modules in order to examine connections between
natural language documentation and source code quality. And
finally, we compare the comment quality results generated
using our JavadocMiner with the quality assessments performed manually by undergraduate and graduate computer science students.

Divisions:Concordia University > Gina Cody School of Engineering and Computer Science > Computer Science and Software Engineering
Item Type:Thesis (Masters)
Authors:Khamis, Ninus
Institution:Concordia University
Degree Name:M.A. Sc.
Program:Software Engineering
Date:14 April 2011
Thesis Supervisor(s):Rilling, Juergen and Witte, René
Keywords:Ninus, Ninus Khamis, Natural Language Processing, NLP, Artificial Intelligence, AI, Knowledge Representation, Description Logic, Javadoc, Source Code Comments
ID Code:975023
Deposited By: NINUS KHAMIS
Deposited On:17 Jan 2017 16:43
Last Modified:18 Jan 2018 17:39

Available Versions of this Item

All items in Spectrum are protected by copyright, with all rights reserved. The use of items is governed by Spectrum's terms of access.

Repository Staff Only: item control page

Downloads per month over past year

Research related to the current document (at the CORE website)
- Research related to the current document (at the CORE website)
Back to top Back to top