Verzorg de definities - Githubissues

mvanbrab commented 4 years ago

Sommige definities zijn niet genoeg verzorgd. Best eens de hele lijst overlopen (voor beide vocabularia en beide applicatieprofielen).

Enkele voorbeelden (dit is geen limitatieve lijst):

Eigenschap default (in Ruimtelijke Eenheid Geometrie) "Geometrie die moet worden gebruikt bv bij voorstelling op kaart." Deze definitie is onduidelijk, zeker bij een eigenschap met verwachte type Boolean. Bovendien gebruikt ze een voorbeeld. Voorbeelden kunnen beter los van een sluitende definitie verhuizen naar "Gebruik".
Eigenschap dimensie (in Ruimtelijke Eenheid) "De dimensie van de ruimtelijke eenheid." Deze definitie is circulair.
Zakelijk Recht "De zakelijke rechten zijn rechten die rechtstreeks op een zaak worden uitgeoefend. Een zakelijk recht geef aan zijn titularis een rechtstreekse en onmiddellijke macht over de zaak waarop het is gevestigd. Een zakelijk recht is een absoluut recht, in die zin dat zijn titularis het tegen iedereen kan doen gelden." Deze definitie begint met een herhaling van het begrip zelf, bevat overbodige informatie die beter in "Gebruik" kan staan en is niet aangepast aan de context van het model: Kan misschien beter zo: "Recht dat aan de betrokken agent een rechtstreekse en onmiddellijke macht geeft op het betrokken kadastraal patrimoniumperceel." Terwijl de nota "Gebruik" in dit geval zou kunnen worden uitgebreid naar: "Deze definitie is gealigneerd met de definitie van de Algemene Administratie van de PatrimoniumDocumentatie (AAPD). 'De zakelijke rechten zijn rechten die rechtstreeks op een zaak worden uitgeoefend. Een zakelijk recht geeft aan zijn titularis een rechtstreekse en onmiddellijke macht over de zaak waarop het is gevestigd. Een zakelijk recht is een absoluut recht, in die zin dat zijn titularis het tegen iedereen kan doen gelden.'"
Eigenschap beperking (in Bedrijventerreinperceel) "Deze eigenschap geeft aan welke de mogelijk beperking een bepaald bedrijventerreinperceel momenteel ondervindt." Deze definitie bevat taalfouten (en zo zijn er nog vele met taalfouten en/of typo's).

Ter informatie: de modelleringsregels https://github.com/Informatievlaanderen/OSLO-handleiding/blob/master/Modellering/OSLO-Modelleringsregels.pdf bevatten richtlijnen voor definities. Deze issue verwijst voornamelijk naar de volgende; " REGEL: Gebruik geen circulaire beschrijvingen. Bv niet: een PubliekeOrganisatie is een organisatie die publiek is. REGEL: Begin een definitie niet met het herhalen vd naam vh concept. Bv voor Adres: “Een Adres is informatie die toelaat om…” moet zijn “Informatie die toelaat om…”. REGEL: Een definitie is een samenvattende omschrijving, zorg dat ze geen voorbeelden of bijkomende uitleg bevat. Aanvullende omschrijvingen worden gegeven in de tag usageNote, zie §3.2.19. "