Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Splitsen design_decisions.md in ontwerprichtlijnen en architectuurprincipes #27

Open
fsamwel opened this issue Apr 19, 2020 · 4 comments
Assignees

Comments

@fsamwel
Copy link
Collaborator

fsamwel commented Apr 19, 2020

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
Copy link
Contributor

melsk-r commented Apr 20, 2020

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
Copy link
Collaborator Author

fsamwel commented Apr 20, 2020

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
Copy link
Contributor

melsk-r commented Apr 22, 2020

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

@melsk-r
Copy link
Contributor

melsk-r commented Sep 7, 2020

Enkele vraagjes:

  • Het opdelen van de design decisions over 'ontwerprichtlijnen' en 'architectuurprincipes' betekent dat we in de id's de string 'DD' vervangen door 'OR' en 'AP'. Aangezien vanuit andere documenten of vanuit discussies naar die id's verwezen moet kunnen worden moeten we voorkomen dat ze steeds wijzigen. We moeten dus wel redelijk zeker zijn van de waarden van de id's. Kunnen we daar vanuit gaan of heb je nog twijfels over de naamgeving van de documenten of kunnen we de id's loskoppelen van de naamgeving van de documenten?
  • In de discussie van Toevoegen aan design_decisions.md (berichtontwerprichtlijnen) #29 hebben we het over het verwijderen van Design Decisions. Dat zal ook in de toekomst gaan gebeuren. Ik stel echter voor dat na het uitvoeren van het onderliggende issue het verwijderen van een item betekent dat een id ook verdwijnt. We gaan dan dus niet meer hernummeren. Dat betekent dat nieuwe items het eerstvolgende vrije nummer krijgen toegekend.
    T.b.v. een logische indeling van de items kunnen nieuwe items tussen al bestaande items worden gevoegd. De nummering van de items hoeft dus niet netjes door te lopen. Kan je je daarin vinden?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants