Configuration-aware software documentation

Configurability is a common property of software allowing programs to be customized for theuser. While configurability is pervasive, it can also lead to faults (or misconfigurations) and make program evolution challenging. Dependencies can be missed, essential code can be left in place when a configuration option is removed, or code can be deleted or changed when still in use by other configuration options. One challenge is a lack of sufficient documentation and traceability between configuration options and code during software evolution, which leads to limited understanding of the impact of changes across large configuration spaces. Existing approaches to solve these problems include automated documentation, analysis of version control history, or the use of special program configuration management languages. However, none of these provides a sufficient solution for managing configuration changes over time. In this thesis, we propose an automated approach called ConfiGen, which provides user-facing documentation and a back-end analysis showing the definitions and uses of configuration options. It includes traceability links to lines of program code and can be used to identify changes during system evolution. We have implemented a prototype of ConfiGen on top of a popular documentation tool and performed an empirical evaluation of its effectiveness on over 10 years of history for three C-language, highly configurable systems. We see that the configuration space becomes increasingly complex across versions, with up to a 40% increase in configuration density per file and a 128% increase in configuration footprint across the documentation, and git history analysis alone is insufficient.

Name thesis:degree_name

Master of Science

Level thesis:degree_level

thesis

Discipline thesis:degree_discipline

Computer science

Grantor

Iowa State University - Thesis & Dissertation

Year dc:date.issued

2026

Author dc:creator

• Ahmmed, Jobayer

Advisor dc:contributor.advisor

• Cohen, Myra, B.

• Computer science

Language dc:language.iso

en_US

Repository record dc:identifier.uri

https://dr.lib.iastate.edu/handle/20.500.12876/106543

OAI identifier oai:identifier

oai:dr.lib.iastate.edu:20.500.12876/106543