https://ehotinger.com/categories/software-architecture/ Recent content in software architecture on Eric Hotinger Hugo -- gohugo.io en-US Sat, 08 Apr 2023 19:32:20 -0700 https://ehotinger.com/blog/engineers-must-own-quality/ Sat, 08 Apr 2023 19:32:20 -0700 https://ehotinger.com/blog/engineers-must-own-quality/ Why Quality & Assurance Teams are Not Enough: Engineers Must Take Responsibility Engineers must own the quality of the code that they write. Typical quality & assurance teams do not reinforce correct ownership. As engineers, our job is to push for quality. We’re the only ones that are close enough to the code to understand the shortcuts we’re taking, what problems we’re creating for the future, and what issues may happen down the road as a result of our actions. https://ehotinger.com/blog/the-most-important-software-documentation/ Tue, 17 Jan 2023 07:45:40 -0800 https://ehotinger.com/blog/the-most-important-software-documentation/ The most important documentation in software engineering is the rationale behind architectural decisions and critical components. This rationale is should be discussed and recorded in a document via design meetings. The design document should contain architectural options which list off pros/cons. The document should have an opinion on the preferred approach and tell the reader why it is the preferred approach. Ideally, the design discussions are also recorded and any feedback is persisted into the architectural design document.