Voeg regel toe voor informatie over talen #333
Conversation
Hiermee standaardiseren we het gebruik van talen, welk formaat taal codes in geschreven moeten worden en welke structuur in een object moet worden gebruikt.
github-actions
Bot
added
Status: In bewerking
| <dt>How to test</dt> | ||
| <dd> | ||
| <ul> | ||
| <li>Analyse all fields and if the field represents a language and ensure either one of the following options applies: |
There was a problem hiding this comment.
Hanteren wij Americaans Engels? In dat geval is het analyze ipv analyse.
There was a problem hiding this comment.
Tot nu toe hebben we overal analyse gebruik in deze teksten. Eigenlijk heb ik geen idee welke we precies kiezen.
Laten we dit in een aparte PR oppakken mochten we dit voor alle regels willen updaten.
There was a problem hiding this comment.
Het document is nu een verzameling van contributies in zowel en-GB als en-US.
There was a problem hiding this comment.
Goed om dit expliciet in de HTML output mee te nemen, daarnaast kan je dan ook hunspell o.i.d. draaien op bijv. PR toevoegingen (in EU is Euro English / en-150 de standaard, feitelijk vooral en-GB, dat gebruiken we ook bij internet.nl voor Platform Standaardisatie).
IETF heeft geen voorkeur, buiten per document consistentie, zie RFC 7322 - RFC Style Guide - 3. RFC Style Conventions - § 3.1. Language en W3C lijkt en-US te zijn gezien W3C Manual of Style - § 11.2 Spelling met de toevoeging W3C Manual of Style - § 4.1 Write for a global audience.
|
Deze wijziging is besproken bij TO API 2026-06-04. Besloten is om een aparte werksessie te organiseren om deze regel verder uit te werken. Initiële feedback is vergelijkbaar met de eerste versie van een regel voor Date & Time: er zijn meerdere aspecten die moeten worden uitgewerkt in aparte regels. Hierbij is formaat 1 ding, maar ook "language negotiation" en of enkel header of ook in de body de tags moeten worden doorgegeven. |
|
De structuur die https://test.121.global/docs/ gebruikt is een JSON object waarbij de key de taalcode is en de value dan de waarde. Voorbeeld: "programFspConfigurationLabel": {
"en": "Safaricom M-Pesa",
"fr": "Safaricom M-Pesa"
} |
4 participants
Hiermee standaardiseren we het gebruik van talen,
welk formaat taal codes in geschreven moeten worden en welke structuur in een object moet worden gebruikt.
Fixes #308