fix(docs): vertaal mermaid-diagram in de NL-handleiding + poort tegen onvertaalde diagrammen (#1278) #1284

Merged

brenno merged 3 commits from fix/1278-docs-mermaid-nl into main

2026-08-05 19:51:19 +00:00

brenno commented

2026-08-05 19:45:34 +00:00

Owner

docs/USER_GUIDE.nl.md: de zes diagram-labels vertaald naar het Nederlands (knoop-ID's en mermaid-syntaxis intact).
tool/check_translated_mermaid.dart (+ test, in STATIC_GATES/make check): faalt als een gegenereerde docs/NAME.<taal>.md een mermaid-blok bevat dat byte-identiek is aan de Engelse bron — vangt de klasse voor alle huidige en toekomstige talen, met witte lijst voor taalneutrale diagrammen.
tool/translate_docs.dart: gedocumenteerd dat mermaid-labels handwerk vergen (een generieke mermaid-parser zou de syntaxis breken); de poort dwingt het af.

Closes #1278

🤖 Generated with Claude Code

De Nederlandse handleiding toonde onder "In het kort verplaatst een deck zich als volgt door OciDeck" een mermaid-flowchart met Engelse labels: de machinale docs-vertaling (#1181) laat codeblokken — en dus mermaid — ongemoeid, waardoor de labels in de brontaal blijven. - **docs/USER_GUIDE.nl.md**: de zes diagram-labels vertaald naar het Nederlands (knoop-ID's en mermaid-syntaxis intact). - **tool/check_translated_mermaid.dart** (+ test, in `STATIC_GATES`/`make check`): faalt als een gegenereerde `docs/NAME.<taal>.md` een mermaid-blok bevat dat byte-identiek is aan de Engelse bron — vangt de klasse voor alle huidige en toekomstige talen, met witte lijst voor taalneutrale diagrammen. - **tool/translate_docs.dart**: gedocumenteerd dat mermaid-labels handwerk vergen (een generieke mermaid-parser zou de syntaxis breken); de poort dwingt het af. Closes #1278 🤖 Generated with [Claude Code](https://claude.com/claude-code)

brenno added 3 commits

2026-08-05 19:45:35 +00:00

fix(docs): vertaal het mermaid-stroomschema in de NL-handleiding (#1278 ) 9b52bf0f77

De Nederlandse gebruikershandleiding toonde het stroomschema onder "In het
kort verplaatst een deck zich als volgt door OciDeck" met Engelse labels. De
labels zijn nu Nederlands, met de knoop-ID's en mermaid-syntaxis intact.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

test(docs): poort tegen byte-identieke mermaid-blokken in vertaalde docs (#1278 ) 57695655f8

Een gegenereerde docs/NAME.<taal>.md mag geen mermaid-blok dragen dat
byte-identiek is aan de Engelse bron docs/NAME.md — de vertaler laat
codeblokken (en dus mermaid) ongemoeid, dus zulke labels blijven onvertaald.

tool/check_translated_mermaid.dart vergelijkt elk mermaid-blok per variant
met de basis en faalt op een identiek (onvertaald) blok, met een expliciete
witte lijst voor echt taalneutrale diagrammen (nu leeg). De poort is bewust
afhankelijkheidsvrij (alleen dart:io): een STATIC_GATES-tool die
package:ocideck importeert trekt de native FFI-laag door de dart-run
kernelcompiler, die op deze toolchain crasht. Bedraad in STATIC_GATES en
gedocumenteerd in docs/CHECKS.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs(translate): leg vast waarom mermaid-labels handwerk blijven (#1278 )

scans / scans (pull_request) Successful in 1m56s

Details

static-gate / static-gate (pull_request) Successful in 4m27s

Details

96277f779f

translate_docs.dart vertaalt bewust geen mermaid-labels: mermaid heeft een
dozijn knoopvormen en per diagramtype een andere tekstsyntaxis, verweven met
regels die juist niet vertaald mogen worden (classDef, style, click). Een
gedeeltelijke extractor zou precies de fragiele parser zijn die een diagram
stukmaakt — het risico dat de vertaler ontwijkt door codeblokken over te
slaan. De poort uit check_translated_mermaid.dart dwingt de handmatige pas af.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

brenno merged commit 58fe15cbc5 into main

2026-08-05 19:51:19 +00:00

brenno deleted branch fix/1278-docs-mermaid-nl

2026-08-05 19:51:19 +00:00

brenno referenced this pull request from a commit

2026-08-05 19:51:20 +00:00

fix(docs): vertaal mermaid-diagram in de NL-handleiding + poort tegen onvertaalde diagrammen (#1284)

brenno referenced this pull request

2026-08-05 19:51:51 +00:00

[Bug] plaatjes in Nederlandse handleiding zijn engels #1278

brenno referenced this pull request

2026-08-06 00:20:40 +00:00