Use Architecture Decision Records (ADR)

[mhellmeier]

🚀 Feature Request

Current Problem

During the development of this project, different architectural decisions were made. For external people, it is hard to understand why different decisions are made and what the background is. Further, discussions can start in the future from aspects already discussed in the past.

Proposed Solution

To prevent duplicate discussions and be transparent, architecture decision records (ADRs) should be used. There should be an ADR template with a location where all ADRs are stored (like in a docs/adr folder). All ADRs should have the same structure and be easily accessible (in Markdown format).

Additional Context

Existing open source available examples or templates should be used.