Lessons Learned: arc42 in a Real Devops Team - DevConf.CZ 2021

Speaker: Johannes Dienst In this presentation, the speaker will talk about his experiences, successes and failures with the arc42 architecture template in a DevOps team in a corporate environment with a product development focus. Product development is often characterized by short iteration cycles and is therefore often operated in an agile manner, as in the speaker's team. There the existing unstructured documentation was transferred to the arc42 template and stored in a wiki. In the course of time, it turned out that tooling plays a decisive role for the quality of the documentation and therefore switched to Docs-as-Code. In the course of the presentation, the most important decision points for the current iteration of the technical software architecture will be discussed. These include the handling of 'developer prose', outdated documentation and the architecture decisions that are particularly important for a DevOps team. The integration into the methodical procedure Kanban was made possible with arc42 and a microsite based on AsciiDoc. Not left out are the mistakes made, such as missing quality assurance of created documentation or the mixing of business and technical topics. Schedule: https://sched.co/gmLX