Unveiling Architecture Documentation: Brazilian Stakeholders in Perspective
Crescencio Rodrigues Lima Neto, Christina von Flach Chavez, Eduardo, Santana de Almeida, Dominik Rost, Matthias Naab

TL;DR
This paper surveys Brazilian software industry stakeholders to identify current challenges and future needs in architecture documentation, emphasizing the importance of updated information, automation, and cultural change for improved practices.
Contribution
It provides insights into Brazilian stakeholders' needs and highlights the necessity of cultural change and automation in architecture documentation processes.
Findings
Brazilian stakeholders require updated architecture documents.
Automation can reduce documentation effort.
Active stakeholder participation is essential for effective documentation.
Abstract
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.
Peer Reviews
No public reviews on file for this paper yet. If you reviewed it on a platform where reviews are public (OpenReview, ICLR, NeurIPS, ICML), you can paste yours below so the community can read it here.
Videos
No videos yet. Explain this paper in a talk, walkthrough, or lecture? Add one.
Taxonomy
TopicsSoftware Engineering Research · Software Engineering Techniques and Practices · Information Technology Governance and Strategy
