Comments (1)
Thanks for the question @timo-abele. "Confirmation" is somewhat generic, less expressive and specific than other template section headings. The purpose of the section is to remind everybody who is involved that it is not enough to decide, design and implemenation actions are required to bring the AD to life. Architecture, design, and/or code reviews then confirm that this has actually happened, and that the resulting design and implementation are in line with the decision made.
This blog post has a few more explanations (under "Validation"): https://medium.com/olzzio/the-markdown-adr-madr-template-explained-and-distilled-b67603ec95bb and this one has an example (look for the R in ecADR): https://ozimmer.ch/practices/2020/05/22/ADDefinitionOfDone.html
@koppor your thoughts?
from madr.
Related Issues (20)
- Replace "Deciders" by "Decision Maker(s)"
- Peer repo has a copy of an outdated MADR template
- Link to latest releases in each major version from the homepage HOT 1
- Use GitHub template feature to speed up usage HOT 3
- 404 - https://adr.github.io/madr/ HOT 3
- Discuss "Good, because" vs. "Pros:" HOT 8
- More general text at the template
- Re-think categories
- "Architectural Decisions" to strengthen "Architecturally Significant" HOT 3
- Broken 'examples.md' link on github.io HOT 2
- Something is wrong with the wording in the template
- Comment on compatibility with IEEE 42010
- Provide "naked" template?
- Most examples are still on template Version 2 (or older) HOT 3
- Hyperlink in status metadata causes YAML parser to report error HOT 7
- Add branches to latest major versions HOT 2
- Decision Drivers / Forces HOT 5
- Think of switching to other theme HOT 3
- Can ADRs replace design docs and RFCs? HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from madr.