Gebruik benamingen zoals gedefinieerd in een gegevenswoordenboek

[melsk-r]

Wanneer er een gegevenswoordenboek (gegevenscatalogus, informatiemodel) bestaat, gebruiken we voor corresponderende resources of voor corresponderende properties in een resource de naam zoals die in het gegevenswoordenbook staat, met inachtneming van de Design Rules voor naamgeving, zoals gebruik (Upper)snakeCase.

Van de naam in het gegevenswoordenboek kan worden afgeweken in o.a. de volgende situaties:

• Weglaten van redundatie in de naam. Bijvoorbeeld "geboortedatum" in een gegevensgroep geboorte nemen we op als 'datum'.
• Uitschrijven van afkortingen. Bijvoorbeeld "BSN" nemen we op als 'burgerservicenummer'.
• Toevoegen van context, bijvoorbeeld wanneer het gegeven in een andere context wordt gebruikt dan in het gegevenswoordenboek. Bijvoorbeeld het opnemen van gegeven 'identificatie' van een woonplaats bij een nummeraanduiding wordt property 'woonplaatsIdentificatie'.
• Een van het gegeven via een algoritme afgeleide property. Bijvoorbeeld 'leeftijd' van 'geboortedatum'.

[melsk-r]

JBo: Discussie HK: RM: Discussie MV: Prima om te bespreken GJ: Bespreken JBi: Bespreken

JBo: Deels overnemen, deels bespreken. RM: DD niet presenteren als een regel maar als een richtlijn. JBi: Kwalificatie Regel, Richtlijn etc toevoegen lijkt me een goed idee. Verder lijkt het me een prima punt. Waarom heb je anders een gegevenswoordenboek. Dus gebruiken tenzij je uit kan leggen waarom niet (bijvoorbeeld omdat je aan 1 van de genoemde uitzonderingen voldoet). MV: Ik zou geen afkortingen gebruiken in een informatiemodel, ook om de vertaling naar API's makkelijker te maken.