Gebruik van Markdown Any Decision Records voor vastleggen van besluiten

2024-04-05 | Algemeen

Voor het vastleggen en ondersteunen van discussies leggen we besluiten en voorgenomen besluiten vast als “decision records”.

Context en probleemstelling

We willen discussies vastleggen en ondersteunen met een methodiek, voor meer structuur, zodat we zelf kunnen terugkijken wat er besloten is en waarom, en om dat ook aan de buitenwereld te kunnen verantwoorden.

Overwogen opties

  1. Volgen van de methode van Markdown Any Decision Records (MADR) zoals gebruikt door Federatief Data Stelsel (FDS)
  2. Eigen manier van vastleggen

    Besluit

    We volgen de methode van Markdown Any Decision Records (MADR) zoals gebruikt door Federatief Data Stelsel (FDS)

    Positieve gevolgen

    • Niet zelf het wiel uitvinden
    • Optrekken met FDS

      Negatieve gevolgen

    • Markdown en Git in de vingers krijgen

      Opmerkingen

      Er is een template beschikbaar in Obsidian, zie [[MADR template]], naar aanleiding van artikel https://medium.com/@mttpla/using-obsidian-as-an-adr-tool-5f63d187de6b

    • https://federatief.datastelsel.nl/docs/realisatie/besluiten/00002-decision-records/
    • https://medium.com/@mttpla/using-obsidian-as-an-adr-tool-5f63d187de6b