Metrics for the evaluation of documentation format in agile software projects
Tecnura · 30.06.2026 · 30 (88) · 38-57
DOI: 10.14483/22487638.24849 ↗Kurz gefasst
Fachartikel in der Zeitschrift Tecnura, online erschienen am 30.06.2026. Verfasst von Juan Carlos Narváez und 1 weiteren Autor:innen. Die Arbeit nennt 22 Literaturangaben. Der Volltext ist frei zugänglich (Open Access, CC BY-SA 4.0).
Abstract (Originalsprache)
Objective
This paper proposes a metrics model for assessing and making documentation debt visible in agile software development, with a specific focus on the Format dimension. Methodology: Based on a systematic literature review, the study identified critical risks and applied the Goal-Question-Metric (GQM) paradigm to design indicators. Both subjective metrics, based on perception, and objective metrics, based on structural analysis, were defined to evaluate attributes such as readability, conciseness, and clarity.
Results
A five-dimensional architecture was defined (Structure, Format, Usability, Correlation, and Auditability) and specific metrics were developed for the Format dimension, addressing readability, conciseness, and clarity. These metrics integrate subjective user evaluation with objective structural complexity indicators—such as Average Words per Sentence (PPO)—to quantify risks associated with code misunderstanding and communication failures.
Conclusions
Format deficiencies can give rise to serious risks, including communication failures. The combined use of subjective and objective metrics is essential for a holistic diagnosis, transforming documentation quality into a measurable engineering attribute that can be managed proactively.
Zitieren
APA
Narváez, J. C., & Calvache, C. J. P. (2026). Metrics for the evaluation of documentation format in agile software projects. Tecnura, 30(88), 38-57. https://doi.org/10.14483/22487638.24849
Vancouver
Narváez JC, Calvache CJP. Metrics for the evaluation of documentation format in agile software projects. Tecnura. 2026;30(88):38-57. doi:10.14483/22487638.24849
BibTeX
@article{Narvez2026,
author = {Narváez, Juan Carlos and Calvache, César Jesús Pardo},
title = {Metrics for the evaluation of documentation format in agile software projects},
journal = {Tecnura},
year = {2026},
volume = {30},
number = {88},
pages = {38--57},
doi = {10.14483/22487638.24849}
}
EUVIMED