Skip to content

docs: enhance README with bilingual usage guide and directory details#17

Open
JiayuuWang wants to merge 1 commit intoChinaSiro:mainfrom
JiayuuWang:contribot/enhance-readme
Open

docs: enhance README with bilingual usage guide and directory details#17
JiayuuWang wants to merge 1 commit intoChinaSiro:mainfrom
JiayuuWang:contribot/enhance-readme

Conversation

@JiayuuWang
Copy link
Copy Markdown

Summary

  • Add English translations alongside existing Chinese content (fully bilingual)
  • Add How to Use section with prerequisites and step-by-step instructions for running extract-sources.js
  • Convert source metadata (version, file count, method) to a table for clarity
  • Expand directory structure with descriptions for all top-level folders — including previously undocumented bridge/, server/, schemas/, state/, and components/ directories
  • Add Key Files table highlighting the most important entry points for new readers
  • Preserve all original Chinese content unchanged

Motivation

The current README is almost entirely in Chinese, which limits accessibility for international researchers and developers interested in studying Claude Code's architecture. Many visitors to this repo come from GitHub's global community and would benefit from English documentation.

Additionally, the README doesn't explain how to actually run extract-sources.js — adding a clear usage section with prerequisites lowers the barrier for anyone who wants to reproduce the extraction themselves.

Test plan

  • Verify README renders correctly on GitHub (tables, code blocks, blockquotes)
  • Verify all links in the README are valid
  • Confirm original Chinese content is preserved

🤖 Generated with Claude Code

- Add English translations alongside existing Chinese content
- Add How to Use section with prerequisites and step-by-step instructions
  for running extract-sources.js
- Convert source metadata to a table for clarity
- Expand directory structure with descriptions for all top-level folders
  including bridge, server, schemas, state, and components
- Add Key Files table highlighting the most important entry points
- Preserve all original Chinese content

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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