@inproceedings{4650c5a68b7b41f8b92fca29c1e28393,
title = "To document or not to document? An exploratory study on developers{\textquoteright} motivation to document code",
abstract = "Technical debt represents the situation in a project where developers accept compromises in one dimension of a system in order to meet urgent demands in other dimensions. These compromises incur a “debt”, on which “interest” has to be paid to maintain the long-term health of the project. One of the elements of technical debt is documentation debt due to under-documentation of the evolving system. In this exploratory study, our goal is to examine the different aspects of developers{\textquoteright} motivation to document code. Specifically, we aim to identify the motivating and hindering aspects of documentation as perceived by the developers. The motivating aspects of code documenting we find include improving code comprehensibility, order, and quality. The hindering aspects include developers{\textquoteright} perception of documenting as a tedious, difficult, and time consuming task that interrupts the coding process. These findings may serve as a basis for developing guidelines toward improving documentation practices and encouraging developers to document their code thus reducing documentation debt.",
keywords = "Documentation, Motivation, Technical debt",
author = "Yulia Shmerlin and Irit Hadar and Doron Kliger and Hayim Makabee",
note = "Publisher Copyright: {\textcopyright} Springer International Publishing Switzerland 2015.; 2nd International Workshop on Advances in Services Design based on the Notion of Capabiliy, ASDENCA 2015, 3rd International Workshop on Cognitive Aspects of Information Systems Engineering, COGNISE 2015, 1st International Workshop on Digital Business In... ; Conference date: 08-06-2015 Through 09-06-2015",
year = "2015",
doi = "10.1007/978-3-319-19243-7_10",
language = "American English",
series = "Lecture Notes in Business Information Processing",
publisher = "Springer Verlag",
pages = "100--106",
editor = "Anne Persson and Janis Stirna",
booktitle = "Advanced Information Systems Engineering Workshops - CAiSE 2015 International Workshops, Proceedings",
address = "Germany",
}