Voorbeelden in Nederlands of Engels #569
Labels
STD: ADR
Standaard: API Design Rules
WG: Normatieve rules
issues regarding the normative part of the API design rules
Milestone
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?
The text was updated successfully, but these errors were encountered: