Informatievlaanderen / OSLOthema-Waterkwaliteit

1 stars 1 forks source link

Diagram - vervolledigen en meer begrijpelijk daarstellen voor iedereen #11

Open VMM-MarkA opened 1 year ago

VMM-MarkA commented 1 year ago

Kan men op het diagram:

gezever commented 1 year ago

Beste @VMM-MarkA Digitaal Vlaanderen kiest bewust voor UML als een laagdrempelige communicatiemanier. De volle pijlen betekenen overeving.

GeertThijs commented 5 months ago

Kan men op het diagram:

  • De elementen bij elkaar zetten die bij elkaar horen. I.e. Meetnet, OSLO-ObservantiesEnMetingen naar onder schuiven zodat die kruisingen weg zijn (Kwestie van overzicht en leesbaarheid)

Qua leesbaarheid leek het interessanter om de Bemonsteringsobjectverzameling op dezelfde hoogte te zetten dan de Observatieverzameling (die niet lager kan worden geplaatst).

  • De ontbrekende relaties weergeven

Zou het diagram te druk maken om ook de relaties die als attribuut zijn (bvb Emissiebron.verantwoordelijke->Agent) weergegeven dmv een connector weer te geven. Vlug geteld zijn het al zeker +10 connectoren minder.

  • Alle relaties op dezelfde manier representeren (De ene keer is het een pijl, de andere keer een ID in de kenmerken, ...)

De relaties die echt essentieel zijn om het model te begrijpen zijn dmv connectoren weergegeven, zo vallen ze meest op. De andere zijn als attribuut weergegeven. Zoals gezegd zou het model te ingewikkeld worden als we alle relaties dmv connectoren zouden weergeven.

  • Alle elementen die op de tekening thuishoren er op hun plaats bijzetten, en niet als een los element in de kantlijn laten staan

Ook hier: Datatypes en Enumeraties zijn minder belangrijk om het model te begrijpen en staan daarom in de kantlijn. Idem voor een aantal minder belangrijke of niet uitgewerkte klassen. OPMERKING: niet-uitgewerkte klassen komen doorgaans uit een ander AP waar ze wel centraal worden geplaatst.

  • Het model weergeven in een formaat dat te begrijpen is voor het doelpubliek (Er niet van uitgaan dat iedereen UML 2.0 gecertificeerd is en hier elke dag mee werkt). I.e. Het detail van het diagram mag niet verdwijnen in techniciteit die de mensen niet verstaan.

UML klassendiagrammen bleken in praktijk het meest leesbaar. Je moet wel UML kennen om de modellen op te stellen, maar de modellen lezen lukt tot op zeker niveau ook zonder kennis. Plus dat er geen rdf-verwijzingen opstaan, die zitten verborgen in de tags. Alternatieven zoals rdf-grapher, webvowl of shape-vowl rechts op onderstaande slide werden onderzocht maar zijn nog veel technischer:

image