TechDebt 2023
Sun 14 - Mon 15 May 2023 Melbourne, Australia
co-located with ICSE 2023

Background: Software documentation often struggles to catch up with the pace of software evolution. The lack of correct, complete, and up-to-date documentation results in an increasing number of documentation defects which could introduce delays in integrating software systems. In our previous study on a bug analysis tool called MultiDimEr, we provided evidence that documentation-related defects contribute to a significant number of bug reports. Aims: First, we want to identify documentation defect types contributing to documentation defects and thereby identifying documentation debt. Secondly, we aim to find pragmatic solutions to minimize most common documentation defects to pay off the documentation debt in the long run. Method: We investigated documentation defects related to an industrial software system. First, we looked at the types of different documentation and associated bug reports. We categorized the defects according to an existing documentation defect taxonomy. Results: Based on a sample of 101 defects, we found that a majority of defects are caused by documentation defects falling into the Information Content (What) category (86). Within this category, the documentation defect types Erroneous code examples (23), Missing documentation (35), and Outdated content (19) contributed to most of the documentation defects. We propose to adapt two solutions to mitigate these types of documentation defects. Conclusions: In practice, documentation debt can easily go undetected since a large share of resources and focus is dedicated to deliver high-quality software. This study provides evidence that documentation debt can contribute to increase in maintenance costs due to the number of documentation defects. We suggest to adapt two main solutions to tackle documentation debt by implementing (i) Dynamic Documentation Generation (DDG) and/or (ii) Automated Documentation Testing (ADT), which are both based on defining a single and robust information source for documentation.

Sun 14 May

Displayed time zone: Hobart change

15:45 - 17:15
Architecture and Documentation Technical DebtTechnical Papers / Plenary at Meeting Room 101
Research paper
Identifying Code Changes for Architecture Decay via a Metric Forest Structure
Technical Papers
Wuxia Jin Xi'an Jiaotong University, Yuyun Zhang Xi'an Jiaotong University, Jiaowei Shang Xi'an Jiaotong University, Yi Hou Xi'an Jiaotong University, Ming Fan Xi'an Jiaotong University, Ting Liu Xi'an Jiaotong University
Research paper
Resolving Security Issues via Quality-Oriented Refactoring: A User Study
Technical Papers
Domenico Gigante SER&Practices and University of Bari, Fabiano Pecorelli Jheronimus Academy of Data Science, Vita Santa Barletta University of Bari, Andrea Janes FHV Vorarlberg University of Applied Sciences, Valentina Lenarduzzi University of Oulu, Davide Taibi Tampere University , Maria Teresa Baldassarre Department of Computer Science, University of Bari
Research paper
Towards identifying and minimizing customer-facing documentation debt
Technical Papers
Lakmal Silva Blekinge Institute of Technology, Michael Unterkalmsteiner Blekinge Institute of Technology, Krzysztof Wnuk
Live Q&A
Open Q&A