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
Showing
3 changed files
with
24 additions
and
1 deletions
| ... | @@ -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)。 | ... | ... |
-
Please register or sign in to post a comment