Terminology

The centre says the same thing in three languages, and site/_data/glossary.yml is where it is written down once. Every entry carries the term in English, Bokmål and Nynorsk, an explanation at three reading levels in English and Bokmål, and any settled definitions from standards, policy and the literature.

Four parts of the site read that one file, which is why it is worth keeping right:

• The glossary pages at /about/glossary/, /no/about/glossary/ and /nn/about/glossary/, each showing the term in its own language.
• The inline stretchtext explanations, the dotted-underlined words that unfold in place. {% include stretch.html term="work-package" %} looks the term up by key and follows the page's language and the reader's chosen reading level.
• The Nynorsk pages, which are translated by machine. The Nynorsk term from this file is shown instead of whatever the translator would have made of the Bokmål one.
• The open data at /data/terminology.json and terminology.csv, published CC0 so that a partner, a translator or a language model can reuse the centre's vocabulary.

Adding or changing a term

1. Add an entry to site/_data/glossary.yml with key, term in all three languages, and a text at the standard level in English and Bokmål. simple and advanced are optional and fall back to standard.
2. Run python3 scripts/check_terminology.py. It fails on a missing language, a missing standard text or a repeated key, and it lists the terms written the same way in both Norwegian forms, which is often correct and worth a glance.
3. Rebuild the Nynorsk mirror and read the entry as it comes out: python3 scripts/build_nynorsk.py.

The check also runs in the Web Quality Checks workflow, so an entry missing a language stops the build rather than reaching the site.

Which form to use

The Norwegian terms follow Teknologirådet's glossary of artificial intelligence, which Språkrådet has reviewed. For the centre's own vocabulary, the governance bodies and the roles, the form is whatever the organisation pages use, and those pages are the place to change it. A Nynorsk form identical to the Bokmål one is fine when that is how the word is written: Styret, konsortium, medlem, arbeidspakke.

The Nynorsk column is the reviewed form. That gives it a second job: it is the yardstick for the automatic translation, so when a generated page shows a term the translator invented, the fix is here rather than in the page.

Related

• Nynorsk for how the Nynorsk pages are made and for the translation glossary that repairs them
• Adaptive Content for the reading levels the explanations are written at
• Site Features for the stretchtext mechanism