mirror of https://github.com/prompt-security/clawsec.git synced 2026-06-23 18:31:21 +03:00

Files

T

davida-ps 6f51e53cdd fix(skill-release): report SkillSpector scans on PRs (#267 )

* fix(skill-release): report skillspector scans on PRs

* fix(skill-release): address PR report review comments

* fix(deps): update vite audit chain

* docs(wiki): document skillspector release evidence

* docs(wiki): centralize skillspector release details

2026-06-14 19:28:11 +03:00

README.md

feat(i18n): add multilingual wiki scaffolding, language switcher, and… (#212 )

2026-04-29 09:00:31 +03:00

terminology-en-es.md

feat(i18n): add multilingual wiki scaffolding, language switcher, and… (#212 )

2026-04-29 09:00:31 +03:00

translation-tracker.md

fix(skill-release): report SkillSpector scans on PRs (#267 )

2026-06-14 19:28:11 +03:00

README.md

i18n Pipeline (ClawSec)

This folder defines the translation QA and operations workflow for ClawSec docs.

Goals

Keep English as source of truth.
Make language switching predictable in website/wiki routes.
Preserve technical integrity in translated docs (commands, code blocks, links, package names).

Files

terminology-en-es.md — terminology lock and no-translate terms.
translation-tracker.md — coverage and status by page.
scripts/i18n/qa_check.py — translation integrity QA checker.
scripts/i18n/bootstrap_language_from_en.py — scaffold generator for missing language pages.

Local QA Command

python scripts/i18n/qa_check.py

Or via npm:

npm run i18n:qa

Bootstrap Commands (language scaffolding)

Dry-run for any language:

python scripts/i18n/bootstrap_language_from_en.py --lang <code> --dry-run

Create missing pages for a language:

python scripts/i18n/bootstrap_language_from_en.py --lang <code>

Overwrite existing scaffolds if needed:

python scripts/i18n/bootstrap_language_from_en.py --lang <code> --overwrite

Convenience npm scripts:

npm run i18n:bootstrap:ko
npm run i18n:bootstrap:fr
npm run i18n:bootstrap:de
npm run i18n:bootstrap:ja

What QA checks

Fenced code blocks are preserved exactly from source.
Critical inline technical tokens are preserved.
Absolute URLs from source still exist in translation.
Non-translatable product/skill terms remain unchanged.

CI integration

Workflow: .github/workflows/i18n-qa.yml

Runs on PRs that touch:

README*.md
wiki/**/*.md
scripts/i18n/**
.github/workflows/i18n-qa.yml

Translation backend strategy (local/free-first)

Recommended approach:

Local model for draft translation (NLLB/Marian via CTranslate2 or LibreTranslate self-hosted)
Free API fallback for difficult segments
Human review for high-impact docs (README, install, security pages)

Rollout notes

Add new language under wiki/<lang>/ and README.<lang>.md.
Add language option in pages/WikiBrowser.tsx label map when introducing a new language code.
Update translation-tracker.md for new pages.