Our great sponsors
-
arc42.org-site
(jekyll-based) website for arc42.org - the template for communicating software architectures.
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
Regarding documentation, I created the C4 model for visualising software architecture as a way to introduce some structure into architecture diagrams, because even today most of what I see is still ad hoc boxes and arrows, with little thought into what (abstractions) and how (notation) an architecture is described. My own tooling (https://structurizr.org) allows you to create multiple diagrams from a single model, using an "as code" approach, and you can render those diagrams using a number of different tools.
In addition to a small number of diagrams, I'd recommend something like arc42 or my "software guidebook" (link for a free copy of my book describing this), plus some architecture decision records.