Skip to content

docs: restructure both READMEs for readability - #8

Merged
ctrlcakepro merged 1 commit into
mainfrom
agent/readme-restructure
Sep 18, 2026
Merged

ctrlcakepro merged 1 commit into
mainfrom
agent/readme-restructure

Conversation

@ctrlcakepro

Copy link
Copy Markdown
Owner

Cherry-picks the README restructuring work from agent/readme-layout (split the bilingual README.md into English-only + README.zh-CN.md, add TOC/tables/matching section structure) onto current main, resolving conflicts against the now-merged Qoder-client terminology and incremental-sync/qoder-compat content.

Summary

  • README.md becomes English-only; README.zh-CN.md carries the full Chinese translation
  • Both pages get a centered header, table of contents, and matching section structure
  • Feature lists and the client-configuration index become tables
  • Dedupes the npm/pip install block in the development section
  • Keeps the already-merged "Qoder client" wording (not "Qoder IDE") throughout

Test plan

  • npm run check (17 node tests, 5 python tests, publication check) — all pass

Split the interleaved bilingual README into two single-language
documents and give both the same layout.

- README.md is now English-only; Chinese readers follow the language
  link to README.zh-CN.md, which was already a complete translation.
  This removes ~110 lines of duplicated prose from the English page.
- Both files gain a centered header (badges, language switch, quick
  nav), a table of contents, and matching section structure.
- Feature lists and the client-configuration index become tables;
  the read-only tool list collapses to a single line.
- Setup steps become numbered subheadings; asides (new-to-MCP note,
  DSH env-forwarding limitation, provider-compatibility caveat)
  become blockquotes.
- Deduplicate the repeated npm install / pip install block in the
  development section.
- Fix two places where the Chinese page said less than the English
  one: absolute-path hiding now names display.expose_absolute_paths,
  and a stale claim that the npm CLI creates a virtualenv is removed
  in favor of the managed-engine wording used elsewhere.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ctrlcakepro
ctrlcakepro merged commit 1ae7ffe into main Sep 18, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant