Commit graph

5 commits

Author SHA1 Message Date
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
b2b1d17d39 feat: add multi-language support to docs compilation pipeline
docs-compile.sh:
- Add --language LANG parameter for per-language compilation
- Support language-specific source directories (docs/sl/, docs/en/, etc.)
- Create language subdirectories in output (docs-v0.8.2_24.mar.2026/sl/)
- Default behavior unchanged (compile docs/ root if no --language specified)

docs-sync.cron.sh:
- Add LANGUAGES="sl,en,de,fr,es" configuration (Slovenian primary)
- Loop through each language, call docs-compile.sh per language
- Compile all languages to version-dated language subdirectories

INTEGRATION.md (docs-deployment skill):
- Update examples to show Slovenian as primary language
- Document language configuration format
- Show per-language compilation workflow
- Update Crowdin sync diagrams (sl first, then others)

Rationale:
- Slovenian is prototype default locale/timezone (sl-SI/Europe/Ljubljana)
- Documentation language hierarchy should match system language default
- Crowdin will manage translations (sl as source, others as translations)
- Zero-downtime deployment now supports multiple language versions

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:11:16 +00:00
7f488af56d Phase 3.8: Create docs-deployment skill + Slovenian date format
Add comprehensive docs-deployment skill for host-level multi-language documentation:

SKILL.md:
  - Complete skill definition and guide (600+ lines)
  - Architecture overview and deployment flow
  - Multi-language support (en, de, fr, es)
  - Crowdin integration workflow
  - Troubleshooting guide
  - Quick reference for common tasks
  - Performance metrics and capacity planning

Templates:
  - nginx-vhost-template.conf: Production-ready multi-language routing
    * Language-specific locations (/en/, /de/, /fr/, /es/)
    * Zero-downtime symlink swaps
    * SSL/TLS configuration
    * Security headers and caching
  - language-selector.html: Beautiful language picker UI
    * Mobile-responsive design
    * Supports 4 languages
    * Links to Crowdin translation project

Date Format Fix (User-Facing):
  - Change from YYYYMMDD (20260324) to DD.mon.YYYY (24.mar.2026)
  - docs-compile.sh: Update date generation and validation
  - docs-sync.cron.sh: Update to match compile.sh format
  - All version directories now human-readable: docs-v0.9.0_24.mar.2026

This format is:
  - User-friendly (appears in directory names, documentation)
  - Consistent with Slovenian date preferences
  - Easily sortable (day.month.year order)
  - Clear in translated documentation

Skill enables operators and authors to:
  - Understand the complete documentation deployment system
  - Set up Crowdin projects from scratch
  - Troubleshoot common issues
  - Monitor deployment health
  - Perform rollbacks and manual syncs

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 09:41:57 +00:00
4714bf9d65 Phase 3.1-3.2: Documentation compilation and sync infrastructure
Add complete markdown-to-HTML compilation pipeline and automated sync orchestrator:

- docs-compile.sh: Compiles markdown to HTML with .docignore filtering, version
  naming (docs-v0.9.0_20260324), and automatic index generation
- docs-sync.cron.sh: Orchestrator for automated daily sync (05:00 UTC): git pull,
  compile, validate, atomic symlink swap, cleanup old versions (30-day retention)
- VERSIONING.md: Architecture guide explaining symlink-based zero-downtime
  deployments with instant rollback capability
- DOCUMENTATION-POLICY.md: Policy establishing markdown as single source of truth,
  git rules, sync procedures, monitoring guidelines
- .docignore: Filtering rules excluding internal/sensitive docs from public sites
- .sync-metadata.json: Metadata tracking for sync automation and monitoring
- Pre-commit hook: Appended documentation validation checks

No external dependencies required (no pandoc/pandoc). HTML wrapper uses pure shell
with simple markdown syntax conversion. Tested with 28 markdown source files.

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 09:28:20 +00:00