Skip to content

Commit abc820a

Browse files
committed
docs: make the documentation English-only
Removes the docs/zh tree and the tooling that maintained it: the translate-docs and pre-changelog skills existed only to mirror and translate it, and gen-docs, sync-changelog and write-tui each described a bilingual layout that no longer exists. The VitePress config never wired a locale, so the Chinese pages were built but unreachable from the site navigation. The acp-adapter README pointed readers at two docs/zh paths for the capability matrix and IDE setup; both now point at their English originals.
1 parent d785420 commit abc820a

35 files changed

Lines changed: 34 additions & 6327 deletions

File tree

.agents/skills/gen-docs/SKILL.md

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: Update Pythinker Code CLI user documentation after meaningful code
77

88
## Overview
99

10-
This repository maintains bilingual user documentation under `docs/`. `docs/en/` and `docs/zh/` are mirrored pairs for most pages; update both in the same change. **Changelog is the exception** — English is the source, and Chinese is translated from English.
10+
This repository maintains English-only user documentation under `docs/`.
1111

1212
Use this skill to update the corresponding documentation whenever the codebase has changes that affect product behavior or user experience.
1313

@@ -17,10 +17,9 @@ For a **full pre-release audit** of all pages (detecting hallucinations and cove
1717

1818
This skill depends on the following being in place. If any are missing, stop and report to the user before continuing:
1919

20-
- `docs/` directory with `docs/zh/`, `docs/en/`, and `docs/.vitepress/config.ts` set up (VitePress site).
20+
- `docs/` directory with `docs/en/` and `docs/.vitepress/config.ts` set up (VitePress site).
2121
- `docs/AGENTS.md` style guide — defines source-of-truth rules, terminology table, typography, and writing style.
2222
- `docs/scripts/sync-changelog.mjs` — auto-syncs root `CHANGELOG.md` to `docs/en/release-notes/changelog.md`.
23-
- `translate-docs` skill in `.agents/skills/` — handles bilingual synchronization.
2423

2524
## Workflow
2625

@@ -61,22 +60,14 @@ This skill depends on the following being in place. If any are missing, stop and
6160
- Customization (skills, agents, MCP, hooks, plugins, etc.)
6261
- Configuration (config files, env vars, providers, data locations)
6362
- Reference (CLI subcommands, slash commands, keyboard shortcuts)
64-
- Release notes (`docs/zh/release-notes/breaking-changes.md` if a breaking change is involved)
65-
66-
5. **Sync bilingual content**
67-
68-
Invoke the `translate-docs` skill. It will:
69-
70-
- Sync updated non-changelog pages between `docs/en/` and `docs/zh/`
71-
- Translate the English changelog → Chinese under `docs/zh/release-notes/changelog.md`
63+
- Release notes (`docs/en/release-notes/breaking-changes.md` if a breaking change is involved)
7264

7365
## Rules and conventions
7466

75-
- **Locale sync**: Non-changelog pages stay mirrored between `docs/en/` and `docs/zh/`. Changelog flows English → Chinese.
76-
- **Terminology**: Use the term table in `docs/AGENTS.md` exactly. Do not invent new translations or use synonyms.
67+
- **Terminology**: Use the term table in `docs/AGENTS.md` exactly. Do not invent synonyms.
7768
- **Scope discipline**: Only update sections affected by the recent changes. Do not opportunistically rewrite unrelated docs.
7869
- **Public examples**: Never write real internal endpoints, key names, account names, or service names into docs. Use neutral placeholders such as `https://api.example.com/v1`, `https://registry.example.com/v1/models/api.json`, `example.test`, and `YOUR_API_KEY`.
79-
- **Breaking changes**: If any change is breaking, also update `docs/en/release-notes/breaking-changes.md` (under `## Unreleased`) with `**Affected**` + `**Migration**` subsections, and mirror it in `docs/zh/release-notes/breaking-changes.md`.
70+
- **Breaking changes**: If any change is breaking, also update `docs/en/release-notes/breaking-changes.md` (under `## Unreleased`) with `**Affected**` + `**Migration**` subsections.
8071
- **Do not edit auto-synced files**: `docs/en/release-notes/changelog.md` is regenerated by the sync script; any manual edit will be overwritten.
8172

8273
## Common mistakes

.agents/skills/pre-changelog/SKILL.md

Lines changed: 0 additions & 72 deletions
This file was deleted.

0 commit comments

Comments
 (0)