2.1 KiB
2.1 KiB
EX-05 让章节顺序服从理解依赖
读者目标：从目录设计推导移动范围，保留定义与导航。下列结构是教学样例，不是本次对正文的实际重组。
原结构
| 旧位置 | 内容 |
|---|---|
| guide/01-calls.md | 跨 namespace 调用和 use |
| guide/02-notes.md | handle、显示名、注册讨论、key、归属 |
| guide/03-ui.md | 组件与一个数据调用例子 |
| guide/04-runtime.md | Preflight、inflight 与通信方案 |
新读者在第一章就需要 namespace 和归属概念；notes 难以检索；阶段与通信方案混合；数据调用隐藏在 UI 页中。
目标职责
先建立语言整体模型，然后说明身份、namespace、程序结构和阶段，再进入基础语法及应用。类型与调用为数据读取提供前提，UI 是应用领域之一。
这不要求无限增加文件。身份和 key 具有不同查询任务时可以独立成章；一个只解释两句话的边界可以留在原主题中。
移动映射示范
| 原内容 | 新的主要位置 | 需要同步 |
|---|---|---|
| handle 与显示名 | 身份章 | 术语、key 的前提链接 |
| key 与归属 | namespace 章 | use、调用例子的外部上下文 |
| use 基本形式 | 程序结构章 | EBNF、调用章节短引用 |
| Preflight / inflight | 阶段章 | 函数、数据和 UI 的行为说明 |
| 数据调用 | 数据读取章 | 类型、调用与 UI 的相关链接 |
| 注册讨论和通信方案 | 按当前任务范围单独处理 | 不将讨论过程当成已确定语言规则 |
表中使用主题名说明方法。真实任务必须补齐具体目标文件与锚点，再实施移动。
重组后的检查
从首页进入调用章前，身份和引用已能被理解；直接从搜索进入 use 小节，也能看到本地归属与依赖 key 的区别。术语链接指向唯一主定义，形式文法保留集中入口。
搜索旧路径与旧标题，更新有效入站链接。对无法控制的外部地址，记录兼容措施或已知影响。重组完成不代表原有语法提案被确认。