Three defects found while reviewing the Swedish translation (#33). None of them belong to that branch — all three predate it — so they are collected here instead of being fixed in passing.
1. French uses a term its glossary does not list
solutions/translation/french-glossary.md prescribes coupure de courant for blackout. The pages use perte d'alimentation 11 times and the prescribed term never.
Reproduce:
uv run python scripts/check_glossary.py fr
Either term is defensible. What is not defensible is the glossary saying one thing and every page saying another, because the glossary is what the next translator reads.
Fix: decide which term stays, then make the other one disappear — update the glossary if the pages are right, update the pages if the glossary is right.
2. German uses two terms for the same thing
The German pages say Spannungsausfall 13 times and Stromausfällen twice, for one concept. The glossary lists Stromausfall. A reader who meets both has no way to know they mean the same event.
check_glossary.py does not catch this: the prescribed term does appear, just rarely. The check finds a term that lost its job, not a term that gained a rival. That limitation is recorded in the script's docstring.
Fix: pick one, apply it to all 15 occurrences, and record it in solutions/translation/german-glossary.md.
3. use-cases.md is not in the navigation
docs/en/user-guide/use-cases.md — and its four translations — are missing from the nav: block in mkdocs.yml. The pages build and are reachable by direct URL, but nothing on the site links to them, so effectively 5 pages of written documentation are invisible.
scripts/translation_status.py reports orphaned=0 because it compares the language trees against each other, not against the navigation. The English page is orphaned too, which is why nothing flagged it.
Fix: add it to nav: under User Guide and add a nav_translations entry to all four locales, or delete the pages if they were abandoned deliberately.
Why these were not fixed in #33
That branch adds a language. Editing French and German pages inside it would have made the diff unreviewable for the one thing it actually needs a reviewer for: whether the Swedish reads correctly.
Three defects found while reviewing the Swedish translation (#33). None of them belong to that branch — all three predate it — so they are collected here instead of being fixed in passing.
1. French uses a term its glossary does not list
solutions/translation/french-glossary.mdprescribescoupure de courantfor blackout. The pages useperte d'alimentation11 times and the prescribed term never.Reproduce:
Either term is defensible. What is not defensible is the glossary saying one thing and every page saying another, because the glossary is what the next translator reads.
Fix: decide which term stays, then make the other one disappear — update the glossary if the pages are right, update the pages if the glossary is right.
2. German uses two terms for the same thing
The German pages say
Spannungsausfall13 times andStromausfällentwice, for one concept. The glossary listsStromausfall. A reader who meets both has no way to know they mean the same event.check_glossary.pydoes not catch this: the prescribed term does appear, just rarely. The check finds a term that lost its job, not a term that gained a rival. That limitation is recorded in the script's docstring.Fix: pick one, apply it to all 15 occurrences, and record it in
solutions/translation/german-glossary.md.3.
use-cases.mdis not in the navigationdocs/en/user-guide/use-cases.md— and its four translations — are missing from thenav:block inmkdocs.yml. The pages build and are reachable by direct URL, but nothing on the site links to them, so effectively 5 pages of written documentation are invisible.scripts/translation_status.pyreportsorphaned=0because it compares the language trees against each other, not against the navigation. The English page is orphaned too, which is why nothing flagged it.Fix: add it to
nav:under User Guide and add anav_translationsentry to all four locales, or delete the pages if they were abandoned deliberately.Why these were not fixed in #33
That branch adds a language. Editing French and German pages inside it would have made the diff unreviewable for the one thing it actually needs a reviewer for: whether the Swedish reads correctly.