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

Voorbeelden in Nederlands of Engels #569

Open
strijm opened this issue Mar 2, 2023 · 1 comment
Open

Voorbeelden in Nederlands of Engels #569

strijm opened this issue Mar 2, 2023 · 1 comment
Labels
STD: ADR Standaard: API Design Rules WG: Normatieve rules issues regarding the normative part of the API design rules
Milestone

Comments

@strijm
Copy link
Collaborator

strijm commented Mar 2, 2023

Originele opmerking op geo-module:
"Tekst is in het Engels, maar veel voorbeelden hebben Nederlandse termen. Waarom niet alles in het Engels? Dat maakt het geheel veel leesbaarder. bijv. api/v1/buildings ipv api/v1/panden"

Binnen de geo module zijn we van mening dat niet strikt Engels of Nederlands voorgeschreven hoeft te worden.
Voorbeelden in het Engels sluiten goed aan bij de Engelse tekst, maar veel OAS specificaties zullen in het Nederlands zijn.
We vinden dat fictieve voorbeelden best in het Engels kunnen zijn en evt. concrete voorbeelden uit een API in het Nederlands. Kortom, beide is mogelijk. Moet dit in de NL API Strategie of core worden beschreven om te voorkomen dat dergelijke opmerkingen bij reviews van iedere module terug blijven komen?

@strijm strijm mentioned this issue Mar 13, 2023
10 tasks
@fterpstra fterpstra added this to the ADR v2.1.0 milestone May 13, 2024
@mrtn78 mrtn78 added WG: Normatieve rules issues regarding the normative part of the API design rules STD: ADR Standaard: API Design Rules labels May 13, 2024
@sanderke
Copy link
Collaborator

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
STD: ADR Standaard: API Design Rules WG: Normatieve rules issues regarding the normative part of the API design rules
Projects
None yet
Development

No branches or pull requests

4 participants