docs(s16): March-feel ideal chapter + maintainer readability standard - #514
Draft
CrazyBoyM wants to merge 11 commits into
Draft
docs(s16): March-feel ideal chapter + maintainer readability standard#514CrazyBoyM wants to merge 11 commits into
CrazyBoyM wants to merge 11 commits into
Conversation
Retell the Runtime lesson as a progressive story (two doors, kitchen primitives, null-isolation, longest-prefix resume) in EN/ZH/JA, and align the mini-runtime with Claude Code / Pi semantics so the docs and code agree. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ❌ Deployment failed View logs |
learn-claude-code | c9e1803 | Aug 12 2026, 07:33 PM |
Ground the progressive chapter in why custom harnesses exist, the three single-window failure modes, dynamic vs static, tasteful patterns, when not to use workflows, and sharp neighbors (s06/s13/s15/s17). Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Rewrite EN/ZH/JA for tea-conversation cadence: soft transitions, insight before jargon, fewer checklist piles — same design spine, warmer prose. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Introduce Classify-And-Act through Loop Until Done after primitives, map each onto agent/parallel/pipeline, show review-changes as a fanout+verify composition, and add a matching six-panel SVG. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Full rewrite of EN/ZH/JA as a progressive essay with harness-essay spine, six-pattern toolbox, neighbor comparisons, and SVG-first figures (dynamic-vs-static, primitives, six patterns). Keep null-isolation and longest-prefix resume in the teaching runtime; bump translation-sync to v15. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Pull Anthropic essay PNGs (primitives, dynamic-vs-static, six patterns, quarantine triage) into images/, wire them into EN/ZH/JA with captions, and add a short untrusted-input beat. Drop substitute SVGs for those four. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Add critical-path figures with captions, ASCII topology sketches, labeled teaching-code vs code.py snippets, and details collapses for optional depth. Recompress official PNGs; keep essay spine visible. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
Compress ZH/EN/JA essay into problem → ASCII/figure → minimal code → try it. Move pattern grid, quarantine, primitives card, and overview SVG into details; bump translation-sync to v18. Co-authored-by: Xinlu Lai <CrazyBoyM@users.noreply.github.com>
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.
Summary
Ideal v19 demo rewrite of
s16_workflow_runtime(EN/中文/日本語) following the maintainer readability / March-feel standard.按维护者文档的 ideal v19 示范章:把 s16 拉回「短讲义卡片」节奏(问题 → ASCII/图 → 最小代码 → 试一试),深度进
<details>;并新增docs/maintainers/MARCH_FEEL_AND_READABILITY.md作为文风权威约束。Files
s16_workflow_runtime/README.md/README.zh.md/README.ja.mddocs/maintainers/MARCH_FEEL_AND_READABILITY.md(new)Notes
README.zh.md) rewritten for natural spoken Chinese (v20).