Support quick decision of done

adr / madr

Markdown Architectural Decision Records

https://adr.github.io/madr/

Other

1.39k stars 395 forks source link

Support quick decision of done #32

Open koppor opened 3 years ago

koppor commented 3 years ago

See https://ozimmer.ch/practices/2020/05/22/ADDefinitionOfDone.html for details

This is a checklist.

Is this a thing of MADR or a thing of ADR-Manager?

socadk commented 3 years ago

Checklist in the blog:

[ ] Are we confident enough that this design will work (E)?
[ ] Have we decided between at least two options, and compared them (semi-)systematically (C)?
[ ] Have we discussed among each other and with peers just enough and come to a common view (A)?
[ ] Have we captured the decision outcome and shared the decision record (D)?
[ ] Do we know when to realize, review and possibly revise this decision (R)?

pixelbrackets commented 3 years ago

Imho this is not in the scope of MADR. It may belong to the ADR Manager. Or any other software which is used for the process to create and discuss a ADR.

socadk commented 3 years ago

I agree about the process, the D in ec-ADR can be fulfilled by creating a (M)ADR template instance.

"DoD met on yyyy-mm-yy" could be worth capturing though.

koppor commented 2 years ago

This discussion refs the "Validation" section https://github.com/adr/madr/blob/3.0.0-beta.2/template/adr-template.md#validation.