EUVIMEDEUVIMED entdecken
Open Access · CC BY-SA 4.0

Metrics for the evaluation of documentation format in agile software projects

Juan Carlos Narváez, César Jesús Pardo Calvache

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).

AbstractBibliografische AngabenZitierenVerwandte Studien

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}
}
Kostenlos starten →