docs(guide): Astro-native localization rework + Slovenian batch 1 #210

Merged

clawdie merged 1 commit from docs/localization-astro-native-and-slovenian into main 2026-06-26 10:38:02 +02:00

Conversation 0 Commits 1 Files changed 18 +785 -227

clawdie commented 2026-06-26 09:56:21 +02:00

Owner

Copy link

Reworks docs localization to Astro/Starlight-native and seeds Slovenian translations. Per the decision to drop Crowdin from the live path and make it a future plan.

Localization rework (English)

Rewrote docs/guide/localization/{index,how-it-works,setup,troubleshooting}.md:

• Starlight-native i18n — locales mirror the tree under docs/guide/<lang>/ (English = default locale at the root); the cms-jail Astro deploy builds all locales; no external service in the live path.
• Fixes the stale docs/public/ references — the docs actually live in docs/guide/, and there was no Crowdin config/docs/public//sl/ in the repo, so the old pages described a pipeline that didn't exist.
• Crowdin → Future plan — kept as a clearly-labelled scaling option that would push/pull into the same docs/guide/<lang>/ layout, explicitly not wired up today.

Slovenian — batch 1 (docs/guide/sl/)

A navigable skeleton across every section (top index + all six section indexes + the localization index) plus two fully translated content pages I authored this session:

• operate/terminal-capture.md
• architecture/control-plane-bridge.md

Literal commands / JSON / env-vars stay in English; prose, frontmatter (title/description), and table headers are translated. prettier-clean, no real tailnet IPs (placeholders only).

Scope note

The content-heavy bodies (install/, the rest of operate/, architecture/ deep-dives, reference/, roadmap/ — ~5.5k lines) are batch 2. I'd recommend a native-speaker pass on this batch first, since bulk technical Slovenian from an LLM should be reviewed before scaling. Happy to continue in reviewed batches.

🤖 Generated with Claude Code

Reworks docs localization to **Astro/Starlight-native** and seeds **Slovenian** translations. Per the decision to drop Crowdin from the live path and make it a future plan. ## Localization rework (English) Rewrote `docs/guide/localization/{index,how-it-works,setup,troubleshooting}.md`: - **Starlight-native i18n** — locales mirror the tree under `docs/guide/<lang>/` (English = default locale at the root); the cms-jail Astro deploy builds **all** locales; no external service in the live path. - Fixes the **stale `docs/public/` references** — the docs actually live in `docs/guide/`, and there was no Crowdin config/`docs/public/`/`sl/` in the repo, so the old pages described a pipeline that didn't exist. - **Crowdin → Future plan** — kept as a clearly-labelled scaling option that would push/pull into the same `docs/guide/<lang>/` layout, explicitly *not wired up today*. ## Slovenian — batch 1 (`docs/guide/sl/`) A **navigable skeleton across every section** (top `index` + all six section indexes + the localization index) plus **two fully translated content pages** I authored this session: - `operate/terminal-capture.md` - `architecture/control-plane-bridge.md` Literal commands / JSON / env-vars stay in English; prose, frontmatter (`title`/`description`), and table headers are translated. **prettier-clean**, **no real tailnet IPs** (placeholders only). ## Scope note The content-heavy bodies (`install/`, the rest of `operate/`, `architecture/` deep-dives, `reference/`, `roadmap/` — ~5.5k lines) are **batch 2**. I'd recommend a **native-speaker pass** on this batch first, since bulk technical Slovenian from an LLM should be reviewed before scaling. Happy to continue in reviewed batches. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

clawdie added 1 commit 2026-06-26 09:56:23 +02:00

docs(guide): rework localization to Astro-native + Slovenian batch 1 ... ba19a5e2ca

Localization rework: rewrite docs/guide/localization/{index,how-it-works,
setup,troubleshooting}.md to describe Starlight-native i18n — locales mirror
the tree under docs/guide/<lang>/ (default English at root), the cms-jail
Astro deploy builds all locales, no external service in the live path.
Corrects the stale docs/public/ references (docs live in docs/guide/) and
demotes Crowdin to a clearly-labelled Future-plan note (not wired up today).

Slovenian batch 1 under docs/guide/sl/: navigable skeleton across every
section (top index + all six section indexes + the localization index) plus
two fully translated content pages (operate/terminal-capture,
architecture/control-plane-bridge). Literal commands/JSON/env-vars kept in
English; prose, frontmatter, and table headers translated. prettier-clean,
no real tailnet IPs. Content-heavy bodies (install/operate/architecture/
reference/roadmap) are batch 2, recommended after a native review of this set.

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

claude-domedog added 1 commit 2026-06-26 10:05:01 +02:00

docs(sl): translate stable install pages (requirements, iso, controlplane) ... 331456b11c

Slovenian batch 2 (install/, stable subset): requirements.md, iso.md,
controlplane-install.md. Deliberately skips first-boot.md and install.md —
both carry in-repo "will be rewritten after live ISO validation" notes, so
translating them now would be wasted effort. Commands/URLs/env-vars kept in
English; prose + frontmatter + tables translated. prettier-clean, no IPs.

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

codex-osa added 1 commit 2026-06-26 10:12:57 +02:00

docs(sl): native-speaker corrections for Slovenian batch 1 ... a6156315c4

- root namestitev (ne korenska) — uporabnik pozna 'root'
- Colibri se odzove avtomatično (ne 'oglaša v trenutku')
- ProtectHome=yes → uporabnikova domača mapa ni vidna
- Hive mode sekcija z dvojino (OSA in domedog sta vzpostavila most)
- lokalni modeli umetne inteligence (ne 'UI modeli')

codex-osa force-pushed docs/localization-astro-native-and-slovenian from a6156315c4 to 0132c663d7 2026-06-26 10:15:22 +02:00 Compare

codex-osa force-pushed docs/localization-astro-native-and-slovenian from 0132c663d7 to 57c96c3221 2026-06-26 10:29:18 +02:00 Compare

codex-osa force-pushed docs/localization-astro-native-and-slovenian from 57c96c3221 to ca087846ec 2026-06-26 10:29:31 +02:00 Compare

codex-osa force-pushed docs/localization-astro-native-and-slovenian from ca087846ec to a3048cdef2 2026-06-26 10:34:55 +02:00 Compare

clawdie merged commit ec1e652831 into main 2026-06-26 10:38:02 +02:00

clawdie referenced this pull request from a commit 2026-06-26 10:38:05 +02:00

Merge pull request 'docs(guide): Astro-native localization rework + Slovenian batch 1' (#210) from docs/localization-astro-native-and-slovenian into main

clawdie referenced this pull request 2026-06-26 10:50:35 +02:00

docs(guide): correct install docs to the clawdie binary (drop clawdie-ai just/Ansible) #213

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

first-proof blocker

gates the first proven end-to-end

  

hardening

security/robustness follow-up, not a first-proof gate

No labels

first-proof blocker

hardening

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

3 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: clawdie/colibri#210

No description provided.