Decide the wiki structure, page names and languages (ADR-0001) #46

Merged
Tirsvad merged 2 commits from mil-005-wiki-structure-decision into main 2026-10-10 03:14:54 +02:00
Owner

Records the decision for MIL-005 task 1: wiki structure, page names and languages.

Changes

  • New ADR-0001 (Proposed):
    • five pages: Home, Onboarding, Credentials, Troubleshooting, Capabilities;
    • the English page has no suffix and is generated; a translation is <Page>.da or <Page>.ms, written by hand in wiki/<Page>.<lang>.md, reviewed by a native reader and published by the same workflow;
    • English is authoritative;
    • each translation starts with <!-- translation of <Page>.md, source sha256 <12 hex> --> so a stale translation is detectable offline;
    • code blocks, commands, file names and workflow error messages stay in English; terms are kept consistent through docs/wiki-terms.md (task 4).
  • Registry: ADR row added (next number 0002); the Languages paragraph states the naming rule and points to the ADR.

Review status

  • ADR-0001 is Proposed. It needs a QC-ADR-001 review (RC record) and a Go before tasks 4 and 5 build on it.
  • Dots in wiki page names are not verified on this wiki. MIL-005 task 7 (#38) must publish and open them; the fallback is Home_da.
  • The staleness check and the language switcher line are task 4 (#35) work.

Closes #32

Records the decision for MIL-005 task 1: wiki structure, page names and languages. ## Changes - New **ADR-0001** (`Proposed`): - five pages: Home, Onboarding, Credentials, Troubleshooting, Capabilities; - the English page has no suffix and is generated; a translation is `<Page>.da` or `<Page>.ms`, written by hand in `wiki/<Page>.<lang>.md`, reviewed by a native reader and published by the same workflow; - English is authoritative; - each translation starts with `<!-- translation of <Page>.md, source sha256 <12 hex> -->` so a stale translation is detectable offline; - code blocks, commands, file names and workflow error messages stay in English; terms are kept consistent through `docs/wiki-terms.md` (task 4). - Registry: ADR row added (next number 0002); the Languages paragraph states the naming rule and points to the ADR. ## Review status - ADR-0001 is `Proposed`. It needs a QC-ADR-001 review (RC record) and a Go before tasks 4 and 5 build on it. - Dots in wiki page names are not verified on this wiki. MIL-005 task 7 (#38) must publish and open them; the fallback is `Home_da`. - The staleness check and the language switcher line are task 4 (#35) work. Closes #32
Tirsvad added 2 commits 2026-10-10 03:14:28 +02:00
English pages are generated and have no suffix; translations are named
<Page>.da and <Page>.ms, written by hand in wiki/, reviewed and checked for
staleness through a source hash. Add the ADR type to the registry.
Resolve pending commit link in ADR-0001
Validate workflows / validate (pull_request) Successful in 13s
20e02535bc
Tirsvad merged commit 8767741c0c into main 2026-10-10 03:14:54 +02:00
Tirsvad deleted branch mil-005-wiki-structure-decision 2026-10-10 03:14:58 +02:00
Sign in to join this conversation.