Adopt Architecture Decision Record (ADR)

[dawehner]

@francescopersico suggest to use Architecture Decision Record (ADR) to document decisions in a nice and standardized way.

Introduction blog post: http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions

Template:

https://github.com/joelparkerhenderson/architecture_decision_record/blob/master/adr_template_by_michael_nygard.md

Examples:

• https://github.com/teamdigitale/italia-backend/blob/master/doc/architecture/decisions/0002-backend-runs-on-docker-on-local-environments.md
• https://github.com/teamdigitale/italia-backend/blob/master/doc/architecture/decisions/0003-use-openapi-to-defined-the-api-specs.md

[dawehner]

ADR seems to be a quite lightweight way of dealing with those kind of decisions.

[justafish]

@dawehner could you provide some examples please?

[dawehner]

Good point. I updated the summary with the template, a blog post and some examples