TODO or To Bug: Exploring How Task Annotations Play a Role in the Work Practices of Software Developers

  1. (PDF, 448 KB)
AuthorSearch for: ; Search for: ; Search for: ; Search for: ; Search for:
ConferenceProceedings of the International Conference on Software Engineering 2008 (ICSE 2008), May 10-18, 2008., Leipzig, Germany
Subjectdocumentation; human factors; task annotations; work practices; source code comments; facteurs humains; annotation des tâches; pratiques de travail; commentaires du code source
AbstractSoftware development is a highly collaborative activity that requires teams of developers to continually manage and coordinate their programming tasks. In this paper, we describe an empirical study that explored how task annotations embedded within the source code play a role in how software developers manage personal and team tasks. We present findings gathered by combining results from a survey of professional software developers, an analysis of code from open source projects, and interviews with software developers. Our findings help us describe how task annotations can be used to support a variety of activities fundamental to articulation work within software development. We describe how task management is negotiated between the more formal issue tracking systems and the informal annotations that programmers write within their source code. We report that annotations have different meanings and are dependent on individual, team and community use. We also present a number of issues related to managing annotations, which may have negative implications for maintenance. We conclude with insights into how these findings could be used to improve tool support and software process.
Publication date
AffiliationNRC Institute for Information Technology; National Research Council Canada
Peer reviewedNo
NRC number50378
NPARC number5765766
Export citationExport as RIS
Report a correctionReport a correction
Record identifier6bda32ff-748d-4525-8195-f3a0d24354a6
Record created2009-03-29
Record modified2016-05-09
Bookmark and share
  • Share this page with Facebook (Opens in a new window)
  • Share this page with Twitter (Opens in a new window)
  • Share this page with Google+ (Opens in a new window)
  • Share this page with Delicious (Opens in a new window)
Date modified: