Date: 14.08.2019
accepted
We want to record architectural decisions made on the Ditto project to keep track of the motivation behind certain decisions.
We will use Architecture Decision Records, as described by Michael Nygard in this article and also use the proposed template.
From Michael Nygard's article (link above):
The motivation behind previous decisions is visible for everyone, present and future. Nobody is left scratching their heads to understand, “What were they thinking?” and the time to change old decisions will be clear from changes in the project's context.