Skip to content

docs: make all documentation bilingual, English first - #117

Merged
lweberru merged 1 commit into
mainfrom
docs/bilingual-documentation
Oct 17, 2026
Merged

lweberru merged 1 commit into
mainfrom
docs/bilingual-documentation

Conversation

@lweberru

Copy link
Copy Markdown
Collaborator

Summary

  • Keep existing .md URLs as canonical English and add complete German .de.md companions for all 90 Markdown documents.
  • Add reciprocal language navigation, locale-aware cross-page links and compatible heading anchors; document paired maintenance in contributor guidance.
  • Cover Accelerator/module references, workflow catalogue, Configurator user/developer/design guides, operator runbooks and Assistant knowledge reading versions.
  • Preserve generated Terraform contracts and all executable examples. The 19 machine-ingested English Assistant topics remain byte-identical; German companions are human-only and indexed separately.
  • Regenerate only documentation-bound Assistant source fingerprints and the resulting catalogue bundle hash. No prompts, facts, application capabilities, workflow definitions or infrastructure are changed.

Validation

  • 90/90 EN/DE pairs; 1,605 local links/fragments checked without errors.
  • Legacy canonical heading anchors retained; all canonical fenced examples and 68 paired executable example blocks preserved.
  • All 19 curated Assistant source hashes match the pre-translation baseline; generated Terraform blocks remain byte-identical.
  • Pinned Node 24.21.0 / npm 11.19.0: complete npm run check passes, including provenance freshness, lint, build/type-check and 838 passing tests; 66 environment-dependent tests skipped.
  • Final npm run assistant:check and git diff --check pass.

Boundaries

  • Generator-owned technical reference tables intentionally remain unchanged in German guides; German introductions identify the canonical reference.
  • No real-model qualification rerun: curated prompt text, selection and capabilities are unchanged. Existing qualification receipts do not certify the new provenance hash; protected release qualification remains mandatory for a future build.
  • No cloud mutation, deployment or production approval.

Translate and pair all 90 Markdown documents, preserve legacy anchors and executable references, and refresh documentation-bound Assistant provenance without changing curated topic text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@lweberru
lweberru merged commit 98e885d into main Oct 17, 2026
13 checks passed
@lweberru
lweberru deleted the docs/bilingual-documentation branch October 17, 2026 10:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant