Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Beschrijven wanneer een module normatief of niet normatief genoemd wordt #571

Open
strijm opened this issue Mar 2, 2023 · 0 comments
Open
Assignees

Comments

@strijm
Copy link
Collaborator

strijm commented Mar 2, 2023

Originele opmerking op geo-module:
"Onduidelijk welk gedeelte van deze tekst normatief is en welk gedeelte enkel informatief is."

In de NL API Strategie Algemeen of in de design rules beschrijven wanneer iets normatief of niet normatief genoemd wordt zowel op module niveau als binnen een module. Waar moeten normatieve en niet normatieve beschrijvingen aan voldoen? Moet er bij normatieve zaken bv. test beschrijvingen worden toegevoegd, zodat er standaard getest kan worden of een API voldoet aan normatieve onderdelen? Deze testen kunnen op developer.overheid.nl worden geïmplementeerd.
Voor niet normatieve zaken kunnen ook test beschrijvingen worden toegevoegd, maar hoe worden deze geïmplementeerd op developer.overheid.nl? Deze kunnen niet standaard op iedere API worden uitgevoerd, bv. omdat ervoor is gekozen om het niet normatieve deel te negeren. Heeft het dan nut om test beschrijvingen toe te voegen?
Hoe wordt er omgegaan met evt. keuzes in een module? Bv.: een API kan een response conform OGC API Features leveren voor gebruik door GIS applicaties of een API kan een alternatieve response leveren bij gebruik in een administratieve toepassing, beide zijn conform de geo-module.

@strijm strijm mentioned this issue Mar 13, 2023
10 tasks
@fterpstra fterpstra self-assigned this May 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants