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
1 ## 2026-06-02 总览页一致性与最短阅读顺序 checkpoint
2
3 完成项:
4 - 修正 `docs/README.md` 中“4 组/5 组”表述不一致问题。
5 - 新增“新 session 最短阅读顺序”,明确交接优先级。
6
7 结论:
8 - 现在总览页不仅能分组导航,也能直接告诉接手者先读什么。
9 - 文档入口自洽性进一步增强。
10
1 ## 2026-06-02 总览页补齐业务导出链入口 checkpoint 11 ## 2026-06-02 总览页补齐业务导出链入口 checkpoint
2 12
3 完成项: 13 完成项:
......
...@@ -12,7 +12,7 @@ ...@@ -12,7 +12,7 @@
12 4. **服务与工程** 12 4. **服务与工程**
13 5. **研究与路线** 13 5. **研究与路线**
14 14
15 建议先只读这 4 组,不必一次看完全部细节文档。 15 建议先只读这 5 组,不必一次看完全部细节文档。
16 16
17 --- 17 ---
18 18
...@@ -53,6 +53,18 @@ flowchart TD ...@@ -53,6 +53,18 @@ flowchart TD
53 53
54 --- 54 ---
55 55
56 ## 2.5 新 session 最短阅读顺序
57
58 如果是新 session 接手,建议直接按这个顺序:
59
60 1. [持续开发交接文档](./session-handoff.md)
61 2. [更新记录](./CHANGELOG.md)
62 3. [业务导出 Cookbook](./business-export-cookbook.md)[开放数据工作流](./open-dataset-workflow.md)
63
64 选择规则:
65 - 做你们自己的业务素材接入:先读 `business-export-cookbook.md`
66 - 做 FMA / MTG-Jamendo 这类开放数据:先读 `open-dataset-workflow.md`
67
56 ## 3. 主文档分组 68 ## 3. 主文档分组
57 69
58 ### A. 项目与架构 70 ### A. 项目与架构
......
...@@ -255,6 +255,7 @@ ...@@ -255,6 +255,7 @@
255 255
256 ### 文档入口最新状态 256 ### 文档入口最新状态
257 - `docs/README.md` 已补齐业务数据接入导航与最短链说明。 257 - `docs/README.md` 已补齐业务数据接入导航与最短链说明。
258 - `docs/README.md` 已新增“新 session 最短阅读顺序”。
258 259
259 ### 最优先待办 260 ### 最优先待办
260 1. 把已完成的 toy bucket baseline 升级为语义 bucket(风格 / 结构 / hard-case)。 261 1. 把已完成的 toy bucket baseline 升级为语义 bucket(风格 / 结构 / hard-case)。
......