Skip to content

Split README into docs/ with a short homepage navigator - #5

Merged
cursor[bot] merged 1 commit into
masterfrom
cursor/docs-split-phase5-a3a2
Sep 15, 2026
Merged

cursor[bot] merged 1 commit into
masterfrom
cursor/docs-split-phase5-a3a2

Conversation

@xuzongbao

@xuzongbao xuzongbao commented Sep 15, 2026

Copy link
Copy Markdown
Owner

Phase 5: restructure only. Teaching meaning is unchanged; examples.yml cases, scripts/check_examples.py, CI, and MIT LICENSE text are untouched (one comment in examples.yml now points at docs/ instead of README).

File map

File What moved here
README.md Short hub: title, positioning, default engine, TOC, how to run check_examples.py, license, deerchao attribution
docs/00-getting-started.md 定位 / 引擎对照、regex101 怎么验证、阅读约定、从例子开始、本文修正过什么
docs/01-basics.md 元字符、字符转义、重复(量词)、字符类、分枝条件
docs/02-groups-and-lookaround.md 分组、反义、反向引用、环视、贪婪与懒惰、注释、标志与选项对照表
docs/03-cookbook.md 常用实战模式
docs/04-caveats.md 什么时候不该用正则(含 ReDoS)
docs/05-advanced.md 进阶索引、附录 B 引擎差异速查
docs/99-appendix-dotnet.md 附录 A:.NET 专有平衡组与递归匹配

Each docs/*.md has prev/next + 目录 links so GitHub navigation still works.

What stayed at the root

  • examples.yml (51 cases; checker path unchanged)
  • scripts/check_examples.py
  • .github/workflows/ci.yml
  • LICENSE

Local run: passed: 49 skipped: 2 failed: 0.

Attribution

章节骨架与致谢仍指向鹿鸣/deerchao《正则表达式30分钟入门教程》,写在首页「参考与致谢」。

Open in Web Open in Cursor 

Move teaching chapters into numbered docs/*.md files, keep examples.yml
and the PCRE2 checker at the repo root, and leave LICENSE unchanged.

Co-authored-by: Elven_xu <799835984@qq.com>
@xuzongbao
xuzongbao marked this pull request as ready for review September 15, 2026 11:25
@cursor
cursor Bot merged commit 2e8e82e into master Sep 15, 2026
1 check passed
@cursor
cursor Bot deleted the cursor/docs-split-phase5-a3a2 branch September 15, 2026 11:30
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.

2 participants