nl-digigo / contractspecificaties

Uitwisselen van contractspecificaties, functies, objecten, werkzaamheden en informatieproducten.
https://nl-digigo.github.io/contractspecificaties/
1 stars 1 forks source link

Verbetervoorstel: interne verwijzingen ook human-readable maken #31

Closed rense-k closed 1 year ago

rense-k commented 2 years ago

Geen idee of het de bedoeling is dat iedereen issues kan aanmaken, maar wilde graag mijn feedback leveren op dit interessante initiatief.

De interne verwijzingen in de tabellen gaan nu middels de URI's. Bijv. in de eistabel wordt de specificeert ingevuld met de URI van het onderwerp. Is het niet wenselijker om hier ook een human-readable verwijzing aan toe te voegen?

Voordelen:

Nadelen:

Wat achtergrond: In het verleden heb ik veel te maken gehad met coins-containers. Doordat een gemiddelde eindgebruiker die niet eenvoudig "even" kan bekijken, kon die geen uitgangscontrole doen. Daardoor werden overduidelijke problemen in zijn geheel niet gespot en kon het voorkomen dat er helemaal geen data in zat, of bepaalde data miste (terwijl die wel in het bronsysteem van de eindgebruiker aanwezig was)

ElisabethKloren commented 2 years ago

Hoi @rrense wat super dat je dit doet, we gaan dit document binnenkort in een openbare consultatie gooien dus je bent nu gewoon de koploper van de koplopers! Feedback is zeker welkom!

ElisabethKloren commented 1 year ago

Ter overweging voor kernteam PCB en gebruikerscommissie: zou hier het juridische vraagstuk ook mee vergemakkelijkt worden? Dat een jurist de dataset zelfstandig kan lezen en controleren?

ElisabethKloren commented 1 year ago

Besluit: weliswaar kunnen dubbelingen voorkomen, en bestaat het gevaar dat deze lijsten handmatig worden aangepast waarbij mensen fouten maken, toch is het argument van leesbaarheid voor mensen zwaarwegender, juist omdat dit een instapmodel moet zijn om de sector in beweging te krijgen. we maken de tabellen meer human-readable.