Skip to content

docs(s01-s20): reduce AI tone, normalize "Claude Code", fix diagrams#384

Open
Bill-Billion wants to merge 2 commits into
shareAI-lab:mainfrom
Bill-Billion:fix/reduce-ai-tone-s01-s20
Open

docs(s01-s20): reduce AI tone, normalize "Claude Code", fix diagrams#384
Bill-Billion wants to merge 2 commits into
shareAI-lab:mainfrom
Bill-Billion:fix/reduce-ai-tone-s01-s20

Conversation

@Bill-Billion

@Bill-Billion Bill-Billion commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

What

A trilingual review pass across all 20 chapters (s01–s20).

READMEs

  • Make README.md the English default, add README.zh.md, keep README.ja.md; drop the old README.en.md.
  • Normalize standalone "CC" → "Claude Code" in READMEs and code.py comments (all 20 chapters, 0 residual).
  • Reword the s09 / s17 chapter titles (zh) for more natural phrasing.

Diagrams (SVG)

  • Merge per-language *.en.svg / *.ja.svg into a single images/*.svg per diagram.
  • Fix / redesign diagrams across s02–s09, s11–s16, s18–s20: overlaps, canvas clipping, mislabeled arrows, wrong tool counts (task(4)task(5), dispatch_by_typedispatch_message), redundant legends, loop-back routing.

Tooling

  • Fix web/scripts/extract-content.ts locale mapping (zhREADME.zh.md, enREADME.md).
  • Regenerate web/public/course-assets/** and web/src/data/generated/{docs,versions}.json.

Merge with upstream

Merged the latest main to resolve conflicts. Upstream fixes that landed after this branch forked were carried into the new trilingual layout:

Verification

  • All diagram fixes rendered (cairosvg) and visually checked.
  • Tool counts / function names verified against each chapter's code.py.
  • 0 residual standalone "CC" across all chapters.

🤖 Generated with Claude Code

Trilingual restructure + review pass across all 20 chapters:

- READMEs: make README.md the English default, add README.zh.md,
  keep README.ja.md; drop the old README.en.md
- SVGs: merge per-language *.en.svg / *.ja.svg into one images/*.svg
- Normalize standalone "CC" -> "Claude Code" in READMEs and code.py
  comments (all 20 chapters, 0 residual)
- Fix / redesign diagrams (s02-s09, s11-s16, s18-s20): overlaps,
  canvas clipping, mislabeled arrows, wrong tool counts (task(4)->task(5),
  dispatch_by_type->dispatch_message), redundant legends, loop-back routing
- Reword s09 / s17 chapter titles (zh)
- Fix extract-content.ts locale mapping (zh->README.zh.md, en->README.md)
- Regenerate web course assets and generated docs/versions JSON

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 23, 2026

Copy link
Copy Markdown

@Bill-Billion is attempting to deploy a commit to the crazyboym's projects Team on Vercel.

A member of the Team first needs to authorize it.

Resolve conflicts from upstream fixes that landed after this branch forked
(shareai/main 20e7cbb -> 2a73474, 9 commits):

- s03_permission: keep the new trilingual layout (drop README.en.md);
  carry the permission-gate example fix (shareAI-lab#375) into README.md/zh.md/ja.md
  ("Delete all temporary files in /tmp" -> "Delete the file test.txt").
- s08_context_compact: keep the new layout (drop README.en.md); port the
  reactive_compact reorder (shareAI-lab#364, summarize only messages[:tail_start]) and
  the snip_compact / reactive_compact guard alignment into README.zh.md.
  The en/ja snippets auto-merged since the code lines are language-neutral.
- s08/s09/s20 code.py reactive_compact reorder and the compaction tests
  come in from upstream unchanged.
- Regenerate web course assets and generated docs/versions JSON.

Co-Authored-By: Claude Opus 4.8 (1M context) <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