DEV Community

max-arshinov
max-arshinov

Posted on

Implementing Simon Brown's Minimal Approach to Software Architecture Documentation

"The question of 'how much documentation should we write?' is often asked, especially in the age of remote work and business continuity planning."

If you've read Simon Brown's (@simonbrown) take on a minimal approach to software architecture documentation, you may have been intrigued by the concept but perhaps left wondering about its implementation.

This repo fills that gap by presenting a concrete implementation template of Simon Brown's approach, which consists of:

  1. Software architecture models as code built with Structurizr Lite
  2. Documentation built with Arc42 template
  3. Decision log built with ADR Tools

Check this out if you've been looking for a robust starter kit for your marvellous adventure in the land of Architecture as Code.

Happy documenting! 📚

Top comments (1)

Collapse
 
der_gopher profile image
Alex Pliutau

Great write-up, we also published an article on C4 recently - packagemain.tech/p/software-archit...