feat(docs): machinevertaal-pijplijn + eerlijke basistaal-melding (#1181) #1204

Merged

brenno merged 1 commit from feat/1181-doc-translations into main

2026-08-04 09:46:39 +00:00

brenno commented

2026-08-04 08:55:26 +00:00

Owner

De mechaniek voor #1181 (handleiding in de taal van de gebruiker). Sluit het issue niet: dit is de pijplijn + de eerlijke basistaal-melding; het genereren van de talen met een gekozen motor is de vervolgstap.

DocumentationService.baseLanguage (en) maakt de basistaal expliciet; de reader-melding "bestaat alleen in het Engels" toont nu voor élke niet-Engelse lezer die terugvalt — Nederlands incl. (voorheen != nl, wat juist de NL-lezer de melding onthield). _resolveKey lost nu ook voor nl een .nl.md-variant op.
tool/translate_docs.dart (make translate-docs): machinevertaalt de gebundelde gebruikersdocs naar elke app-taal, met zichtbare banner; geen ingebakken motor (lokaal-eerst) — TRANSLATOR= wijst een extern commando aan. docs/PRIVACY.md en docs/SECURITY_DESIGN.md worden nooit machinevertaald.
Tests: doc_translation_test.dart + bijgewerkte document_reader_test.dart (39 groen, analyze schoon). Docs: CHANGELOG dev-log + SOURCE_MAP.

Refs #1181

De mechaniek voor #1181 (handleiding in de taal van de gebruiker). Sluit het issue **niet**: dit is de pijplijn + de eerlijke basistaal-melding; het genereren van de talen met een gekozen motor is de vervolgstap. - `DocumentationService.baseLanguage` (en) maakt de basistaal expliciet; de reader-melding "bestaat alleen in het Engels" toont nu voor élke niet-Engelse lezer die terugvalt — Nederlands incl. (voorheen `!= nl`, wat juist de NL-lezer de melding onthield). `_resolveKey` lost nu ook voor nl een `.nl.md`-variant op. - `tool/translate_docs.dart` (`make translate-docs`): machinevertaalt de gebundelde gebruikersdocs naar elke app-taal, met zichtbare banner; geen ingebakken motor (lokaal-eerst) — `TRANSLATOR=` wijst een extern commando aan. `docs/PRIVACY.md` en `docs/SECURITY_DESIGN.md` worden nooit machinevertaald. - Tests: `doc_translation_test.dart` + bijgewerkte `document_reader_test.dart` (39 groen, analyze schoon). Docs: CHANGELOG dev-log + SOURCE_MAP. Refs #1181

brenno force-pushed feat/1181-doc-translations from 6ba795ec9d

scans / scans (pull_request) Successful in 3m6s

Details

static-gate / static-gate (pull_request) Successful in 5m53s

Details

to 3b2930c61e

scans / scans (pull_request) Successful in 2m36s

Details

static-gate / static-gate (pull_request) Successful in 5m17s

Details

2026-08-04 09:07:36 +00:00

Compare