As of result of ADR-0001 we have introduced ADRs to persist architecture-related decisions.
To create and manage ADR-s we use adr-tools.
Only obligatory sections are:
- Name (in first line)
- Context
- Status
- Decision
If there is need for additional you can add them freely :)
To visualize software architecture we have decided to introduce C4Model
C4-PlantUML is used for creating C4 related diagrams.