DEV Community

max-arshinov
max-arshinov

Posted on

2

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! 📚

Image of Docusign

Bring your solution into Docusign. Reach over 1.6M customers.

Docusign is now extensible. Overcome challenges with disconnected products and inaccessible data by bringing your solutions into Docusign and publishing to 1.6M customers in the App Center.

Learn more

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...

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay