Unveiling Architecture Documentation: Brazilian Stakeholders in Perspective
This addresses the challenge of improving software architecture documentation for Brazilian stakeholders, but it is incremental as it builds on existing survey methods without introducing new technical solutions.
The study surveyed 147 industrial participants, including 31 from Brazil, to analyze problems and future wishes regarding software architecture documentation, finding that Brazilian stakeholders need updated documents with the right information and that automation could reduce effort, but cultural changes are needed for active participation.
Over the years, software architecture has become a established discipline, both in academia and industry, and the interest on software architecture documentation has increased. In this context, the improvement of methods, tools, and techniques around architecture documentation is of paramount importance. We conducted a survey with 147 industrial participants (31 from Brazil), analyzing their current problems and future wishes. We identified that Brazilian stakeholders need updated architecture documents with the right information. Finally, the automation of some parts of the documentation will reduce the effort during the creation of the documents. But first, is necessary to change the culture of the stakeholders. They have to participate actively in the architecture documents creation.