docs: remove stale es/ru translations#462
Merged
Merged
Conversation
docs/es/ and docs/ru/ (58 files) last synced around 2026-06-24 and have drifted hard since: the recent docs overhaul reshaped entry points, harness enumerations, README structure, and reference pages in English only, so the translated pages now actively misstate the product. Stale translations are worse UX than none — readers cannot tell what is outdated, and every English change silently widens the gap. Delete both trees and the now-moot Translations section in docs/DOCS-MAINTENANCE.md. No inbound links from the English docs, scripts, or CI reference these trees (verified), so nothing else changes. Localized docs can return later with a sync process that keeps them honest. Closes #461 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: Val Alexander <68980965+BunsDev@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Removes the stale Spanish (docs/es/) and Russian (docs/ru/) documentation trees to prevent users from landing on translations that no longer match the authoritative English docs, and updates the docs maintenance guide accordingly.
Changes:
- Delete the
docs/es/translation tree (including reference/topic pages and “superpowers” notes). - Delete the
docs/ru/translation tree (including reference/topic pages and “superpowers” notes). - Remove the now-stale “Translations” section from
docs/DOCS-MAINTENANCE.md.
Reviewed changes
Copilot reviewed 59 out of 59 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| docs/DOCS-MAINTENANCE.md | Removes the outdated “Translations” maintenance section. |
| docs/es/API-CONTRACT.md | Removes stale Spanish translation page. |
| docs/es/API.md | Removes stale Spanish translation page. |
| docs/es/ARCHITECTURE.md | Removes stale Spanish translation page. |
| docs/es/AUTH.md | Removes stale Spanish translation page. |
| docs/es/CLIENT-INTEGRATION.md | Removes stale Spanish translation page. |
| docs/es/COMUX-DEMO-LOOP.md | Removes stale Spanish translation page. |
| docs/es/CONCEPTS.md | Removes stale Spanish translation page. |
| docs/es/GETTING-STARTED.md | Removes stale Spanish translation page. |
| docs/es/GLOSSARY.md | Removes stale Spanish translation page. |
| docs/es/HARNESS-ADAPTERS.md | Removes stale Spanish translation page. |
| docs/es/PRODUCT-SPEC.md | Removes stale Spanish translation page. |
| docs/es/ROADMAP.md | Removes stale Spanish translation page. |
| docs/es/SAFETY-MODEL.md | Removes stale Spanish translation page. |
| docs/es/SESSION-LIFECYCLE.md | Removes stale Spanish translation page. |
| docs/es/TROUBLESHOOTING.md | Removes stale Spanish translation page. |
| docs/es/harnesses/claude-code.md | Removes stale Spanish translation page. |
| docs/es/harnesses/codex.md | Removes stale Spanish translation page. |
| docs/es/harnesses/copilot-cli.md | Removes stale Spanish translation page. |
| docs/es/harnesses/installing.md | Removes stale Spanish translation page. |
| docs/es/harnesses/provider-auth.md | Removes stale Spanish translation page. |
| docs/es/index.md | Removes stale Spanish translation page. |
| docs/es/install/windows.md | Removes stale Spanish translation page. |
| docs/es/reference/api.md | Removes stale Spanish translation page. |
| docs/es/reference/cli.md | Removes stale Spanish translation page. |
| docs/es/reference/release-notes.md | Removes stale Spanish translation page. |
| docs/es/reference/releasing.md | Removes stale Spanish translation page. |
| docs/es/start/coven-tui.md | Removes stale Spanish translation page. |
| docs/es/superpowers/plans/2026-05-15-tui-chat-module.md | Removes stale Spanish translation page. |
| docs/es/superpowers/specs/2026-05-15-tui-chat-module-design.md | Removes stale Spanish translation page. |
| docs/ru/API-CONTRACT.md | Removes stale Russian translation page. |
| docs/ru/API.md | Removes stale Russian translation page. |
| docs/ru/ARCHITECTURE.md | Removes stale Russian translation page. |
| docs/ru/AUTH.md | Removes stale Russian translation page. |
| docs/ru/CLIENT-INTEGRATION.md | Removes stale Russian translation page. |
| docs/ru/COMUX-DEMO-LOOP.md | Removes stale Russian translation page. |
| docs/ru/CONCEPTS.md | Removes stale Russian translation page. |
| docs/ru/GETTING-STARTED.md | Removes stale Russian translation page. |
| docs/ru/GLOSSARY.md | Removes stale Russian translation page. |
| docs/ru/HARNESS-ADAPTERS.md | Removes stale Russian translation page. |
| docs/ru/PRODUCT-SPEC.md | Removes stale Russian translation page. |
| docs/ru/ROADMAP.md | Removes stale Russian translation page. |
| docs/ru/SAFETY-MODEL.md | Removes stale Russian translation page. |
| docs/ru/SESSION-LIFECYCLE.md | Removes stale Russian translation page. |
| docs/ru/TROUBLESHOOTING.md | Removes stale Russian translation page. |
| docs/ru/harnesses/claude-code.md | Removes stale Russian translation page. |
| docs/ru/harnesses/codex.md | Removes stale Russian translation page. |
| docs/ru/harnesses/copilot-cli.md | Removes stale Russian translation page. |
| docs/ru/harnesses/installing.md | Removes stale Russian translation page. |
| docs/ru/harnesses/provider-auth.md | Removes stale Russian translation page. |
| docs/ru/index.md | Removes stale Russian translation page. |
| docs/ru/install/windows.md | Removes stale Russian translation page. |
| docs/ru/reference/api.md | Removes stale Russian translation page. |
| docs/ru/reference/cli.md | Removes stale Russian translation page. |
| docs/ru/reference/release-notes.md | Removes stale Russian translation page. |
| docs/ru/reference/releasing.md | Removes stale Russian translation page. |
| docs/ru/start/coven-tui.md | Removes stale Russian translation page. |
| docs/ru/superpowers/plans/2026-05-15-tui-chat-module.md | Removes stale Russian translation page. |
| docs/ru/superpowers/specs/2026-05-15-tui-chat-module-design.md | Removes stale Russian translation page. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #461.
What
Removes the stale Spanish and Russian translation trees comprehensively:
docs/es/anddocs/ru/(58 files).docs/DOCS-MAINTENANCE.md.Why
The translations last synced around 2026-06-24 and have drifted hard since — the recent docs overhaul (#446–#450, #453, #457, #459) reshaped entry points, harness enumerations, README structure, and reference pages in English only. The translated pages now actively misstate the product (stale harness lists, superseded release notes, dead structure). Stale translations are worse UX than none: readers can't tell what's outdated, and every English change silently widens the gap.
If demand for localized docs returns, they can be reintroduced alongside a sync process that keeps them honest.
Blast radius
None beyond the deleted trees — verified there are no inbound links from the English docs, README, scripts, or CI (
grepacross*.md,.github/,scripts/). Remaining "translation" hits in the repo are unrelated technical uses (protocol/arg translation).Verification
node --test scripts/onboarding-docs-test.mjs— 13/13 pass.git diff --check— clean.python scripts/check-secrets.py— clean.