Commit d3082ce2 d3082ce279d23129aad391ab099ef90fb12d0425 by cnb.bofCdSsphPA

Make the docs overview self-consistent and add the shortest restart reading path

Constraint: Restrict this checkpoint to navigation documentation only
Rejected: Leave the overview mismatch and rely on users to infer reading order | Restart sessions should get a direct, explicit path
Confidence: high
Scope-risk: narrow
Directive: Keep README focused on compressed navigation and restart order, not on duplicating full specs
Tested: Rechecked 215 relative links across the updated overview, changelog, and handoff docs
Not-tested: No code or training path executed in this navigation-only checkpoint
1 parent ec59c9b1
## 2026-06-02 总览页一致性与最短阅读顺序 checkpoint
完成项:
- 修正 `docs/README.md` 中“4 组/5 组”表述不一致问题。
- 新增“新 session 最短阅读顺序”,明确交接优先级。
结论:
- 现在总览页不仅能分组导航,也能直接告诉接手者先读什么。
- 文档入口自洽性进一步增强。
## 2026-06-02 总览页补齐业务导出链入口 checkpoint
完成项:
......
......@@ -12,7 +12,7 @@
4. **服务与工程**
5. **研究与路线**
建议先只读这 4 组,不必一次看完全部细节文档。
建议先只读这 5 组,不必一次看完全部细节文档。
---
......@@ -53,6 +53,18 @@ flowchart TD
---
## 2.5 新 session 最短阅读顺序
如果是新 session 接手,建议直接按这个顺序:
1. [持续开发交接文档](./session-handoff.md)
2. [更新记录](./CHANGELOG.md)
3. [业务导出 Cookbook](./business-export-cookbook.md)[开放数据工作流](./open-dataset-workflow.md)
选择规则:
- 做你们自己的业务素材接入:先读 `business-export-cookbook.md`
- 做 FMA / MTG-Jamendo 这类开放数据:先读 `open-dataset-workflow.md`
## 3. 主文档分组
### A. 项目与架构
......
......@@ -255,6 +255,7 @@
### 文档入口最新状态
- `docs/README.md` 已补齐业务数据接入导航与最短链说明。
- `docs/README.md` 已新增“新 session 最短阅读顺序”。
### 最优先待办
1. 把已完成的 toy bucket baseline 升级为语义 bucket(风格 / 结构 / hard-case)。
......