Cost-Benefit Analysis of Technical Software Documentation

Simple item page
atmire.migration.oldid1244
dc.contributor.advisorRuhe, Günther
dc.contributor.advisorGarousi, Vahid
dc.contributor.authorZhi, Junji
dc.date.accessioned2013-08-27T20:38:50Z
dc.date.available2013-11-12T08:00:15Z
dc.date.issued2013-08-27
dc.date.submitted2013en
dc.description.abstractSoftware developers often spend a considerable amount of time and effort on writing or maintaining documentation. Therefore, it is necessary to assess how much the documentation actually costs and what it may pay back in return. In a Systematic Mapping (SM) literature study, we collected a set of 69 papers published from 1971-2011 and discovered that more empirical evidence is needed to support the cost-benefit analysis of software documentation. This thesis is intended to fill this gap. We propose Document Cost and Benefit Analyzer (DCBA), a methodology that can be used to comprehensively analyze the costs and benefits of software documentation in software maintenance. To validate DCBA, we report on a case study in which we applied the DCBA methodology to NovAtel Inc. We propose the Cost-Effectiveness Index (CEI) to assess the cost-effectiveness of software documents and explore the relationship between CEI and six other potential impacting factors. Also, we report on a controlled experiment in which 26 students participated. Finally, we propose an automatic visualization tool named DEVis to aid the document evolution analysis. Our findings include (1) Software documentation delays subjects’ completion of experimental tasks, yet helps improve the code quality and makes it easier for in-experienced maintainers to produce quality code, (2) Maintainers spent 10% of the total task time on reading documents in the experimental context, (3) Programming experience does not impact the benefits or costs of documents that maintainers encounter (4) Document type is a factor impacting the cost-effectiveness and other attributes, including the number of authors, the number of visitors, the number of revisions and document size, are not found significantly impacting the cost-effectiveness of documents, (5) Several document visit patterns exist, including Group-sharing, Publication and One-day-only patterns.en_US
dc.identifier.citationZhi, J. (2013). Cost-Benefit Analysis of Technical Software Documentation (Master's thesis, University of Calgary, Calgary, Canada). Retrieved from https://prism.ucalgary.ca. doi:10.11575/PRISM/25474en_US
dc.identifier.doihttp://dx.doi.org/10.11575/PRISM/25474
dc.identifier.urihttp://hdl.handle.net/11023/889
dc.language.isoeng
dc.publisher.facultyGraduate Studies
dc.publisher.institutionUniversity of Calgaryen
dc.publisher.placeCalgaryen
dc.rightsUniversity of Calgary graduate students retain copyright ownership and moral rights for their thesis. You may use this material in any way that is permitted by the Copyright Act or through licensing that has been assigned to the document. For uses that are not allowable under copyright legislation or licensing, you are required to seek permission.
dc.subjectComputer Science
dc.subject.classificationSoftware Documentationen_US
dc.subject.classificationCost-Benefit Analysisen_US
dc.subject.classificationSoftware Documenten_US
dc.titleCost-Benefit Analysis of Technical Software Documentation
dc.typemaster thesis
thesis.degree.disciplineComputer Science
thesis.degree.grantorUniversity of Calgary
thesis.degree.nameMaster of Science (MSc)
ucalgary.item.requestcopytrue
Files
Original bundle
Now showing 1 - 1 of 1
Thumbnail Image
Name:
ucalgary_2013_zhi_junji.pdf
Size:
2.85 MB
Format:
Adobe Portable Document Format
Description:
Download
License bundle
Now showing 1 - 1 of 1
Thumbnail Image
Name:
license.txt
Size:
2.65 KB
Format:
Item-specific license agreed upon to submission
Description:
Download
Collections
Open Theses and Dissertations