Commit graph

4 commits

Author SHA1 Message Date
84cc452497 docs: complete Codex's public/internal restructure alignment
Codex restructured docs on 5 Apr (cc37d2c) into public/ and internal/
subdirectories. This commit completes the alignment work by updating all
references across skills, agents, and generated files.

Changes:

Skills Documentation:
- docs-deployment/SKILL.md: Update doc paths (docs/INSTALL.md → docs/public/install/install.md)
- docs-deployment/INTEGRATION.md: Update example paths for new structure
- agent-setup/SKILL.md: Update references
- ansible-freebsd/SKILL.md: Update references

Agents & Conventions:
- AGENTS.md: Add tmux "testing" window guideline for long-running commands
- AGENTS.md: Update doc path references (INSTALL.md → install.md lowercase)
- README-CLAWDIE.md: Update doc paths
- CROWDIN.md: Update structure references

Build System:
- setup/cms.ts: Improve frontmatter generation (skip files with existing h1)
- scripts/memory/embed-docs.py: Adjust for new structure
- docs-deployment/DOCUMENTATION-POLICY.md: Update guidelines

HTML/Web Output:
- html/: Version bumps, link fixes, manifest updated
- Reflect new public/ structure in rendered docs

Validation:
- All skills reference docs correctly
- Install/setup docs now at docs/public/install/
- Docs build and serve correctly (verified 6 Apr)
- 603 tests passing (from Codex's build)

Co-Authored-By: Codex (Agent) <codex@clawdie.si>
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

---
Build: pass | Tests: pass — Tests  603 passed (603)
2026-04-06 13:22:24 +00:00
cc37d2c8cf Public/internal docs restructure; CMS/verify cleanup (Sam & Codex)
---

Build: pass | Tests: pass - 603 passed (44 files)

---
Build: pass | Tests: pass — Tests  603 passed (603)
2026-04-05 06:29:19 +00:00
d2e6ec0d04 prep: update language configuration for Crowdin v0.9.0 (6 languages)
Updated for regional focus:
- Slovenian (sl) — primary
- English (en) — source
- German (de) — Central Europe
- Croatian (hr) — Balkan
- Serbian (sr) — Balkan
- Russian (ru) — Eastern Europe

Changes:
- .crowdin.yml: Update language mapping (sl, en, de, hr, sr, ru)
- scripts/docs-sync.cron.sh: Update LANGUAGES variable
- CROWDIN.md: Update language table and file structure examples
- docs/{de,hr,sr,ru}/: Create placeholder directories with .gitkeep

Ready for Crowdin project creation (awaiting project ID & API token).

Future additions (v0.9.1+): French, Spanish, Greek, Macedonian

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

---
Build: pass | Tests: FAIL — Tests  2 failed | 487 passed | 10 skipped (499)
2026-03-24 18:25:18 +00:00
47bbcf48a1 feat: add Crowdin integration for multi-language translation workflow
Phase 3.5 Implementation:

**CROWDIN.md** (New — User guide)
- Complete translation workflow documentation
- Step-by-step author → translator → deployment cycle
- Language configuration (sl, de, fr, es with Slovenian primary)
- Troubleshooting guide and FAQ
- Best practices for authors, translators, operators

**.crowdin.yml** (New — Configuration)
- Crowdin API configuration (maps docs/*.md source to docs/{lang}/)
- Language code mapping (English → sl, de, fr, es)
- Auto-commit settings (trigger on 100% translation)
- File hierarchy preservation

**CROWDIN-SETUP.md** (New — Admin guide)
- Step-by-step Crowdin project creation
- GitHub app installation and configuration
- API token management and security
- Initial sync testing and verification
- Translator invitation workflow
- Troubleshooting common setup issues

Workflow (automated):
1. Authors commit English markdown
2. Crowdin webhook pulls (GitHub integration)
3. Translators work on translations (Crowdin UI)
4. Crowdin bot commits translations to docs/{lang}/
5. Daily cron @ 05:00 UTC pulls & deploys with zero downtime

Languages: Slovenian (primary) + English, German, French, Spanish (translations)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

---
Build: pass | Tests: FAIL — Tests  2 failed | 487 passed | 10 skipped (499)
2026-03-24 17:15:33 +00:00