VNG-Realisatie / Haal-Centraal-WOZ-bevragen

Project repository tbv de ontwikkeling van de Haal Centraal WOZ Bevragen API
https://vng-realisatie.github.io/Haal-Centraal-WOZ-bevragen/
Other
0 stars 2 forks source link

Als gebruiker wil ik de enumeratiewaarden in gebruikersvriendelijke teksten zien #174

Open KayodeBakker opened 2 years ago

KayodeBakker commented 2 years ago

...zodat er niet allerlei conversies hoeft plaats te vinden om dit mooi leesbaar te maken. Enumeraties met bijv. waarde 'bezwaar_veranderd' waar het eigenlijk '12: bezwaar afgehandeld, vastgestelde waarde veranderd.' had moeten zijn.

Nu wordt er verwacht van afnemers om dit voor eigen gebruikers recht te zetten terwijl dit idealiter in de API al recht wordt gezet. Het meest ideale voorbeeld van een oplossing is dat enumeraties in een waardetabel formaat komen (code is enum, omschrijving is string), maar dat zou een breaking change zijn. Alternatief zou zijn dat op niveau vanwaar een enum staat een omschrijving string property wordt toegevoegd als vertaling. In de omschrijving van de enum kan hiernaar worden verwezen.

Dit is eerder ook besproken bij de BRP API bij issue 828 en bij de BRK API bij issue 946.

Acceptatiecriteria

Definition of done

Let op. Ditzelfde geldt eigenlijk ook voor andere registraties.

KayodeBakker commented 2 years ago

@CathyDingemanse @JohanBoer Ik kan geen assignments doen hier aangezien ik nog niet eerder bij de WOZ Github een issue heb aangemaakt.

CathyDingemanse commented 2 years ago

Done :-)

JohanBoer commented 1 year ago

Het wijzigen van enumeratiewaarden leidt tot een breaking change. Alleen voor deze wijziging willen we de huidige afnemers niet confronteren met een breaking change. Staat getagd voor de eerstvolgende major change.