VNG-Realisatie / Haal-Centraal-common

Project repository tbv de ontwikkeling van de over alle Haal Centraal API specificaties gedeelde specificaties
Other
2 stars 7 forks source link

Splitsen design_decisions.md in ontwerprichtlijnen en architectuurprincipes #27

Open fsamwel opened 4 years ago

fsamwel commented 4 years ago

design_decisions.md bevat nu twee soorten informatie, die geen van beide echt ontwerpbeslissingen zijn.

Een deel van de inhoud betreft richtlijnen en tips voor een berichtontwerper om tot consistent berichtontwerp te komen.

Een deel van de inhoud betreft architectuurprincipes.

Ik stel voor dat dit dan ook in documenten komt met een naam die duidelijk maakt wat het is, waarvoor het is en voor wie het is: respectievelijk "berichtontwerp_richtlijnen.md" en "architectuurprincipes_Haal_Centraal.md"

melsk-r commented 4 years ago

Prima idee, ik ga kijken welke regels in welk document thuishoren. Wat de naamgeving betreft zou ik de woorden in de naam van het eerste document omdraaien en daar ook 'Haal_Centraal' in terug laten komen. Geen 'berichtontwerp_richtlijnen.md' maar 'richtlijnen_berichtontwerp_Haal_Centraal.md'.

fsamwel commented 4 years ago

ja, de naam die je voorstelt is prima. als het maar duidelijk is wat het is. Mijn wens is vooral om heel verschillende dingen, gericht op mogelijk verschillende doelgroep, bij elkaar te stoppen in één document

melsk-r commented 4 years ago

Ok, ik ga eerst maar even de issues #28 en #29 verwerken en daarna deze splitsing aanbrengen.

melsk-r commented 4 years ago

Enkele vraagjes: