43 lines
2.1 KiB
Markdown
43 lines
2.1 KiB
Markdown
# 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 的区别。术语链接指向唯一主定义，形式文法保留集中入口。
|
|
|
|
搜索旧路径与旧标题，更新有效入站链接。对无法控制的外部地址，记录兼容措施或已知影响。重组完成不代表原有语法提案被确认。
|
|
|
|
[对应任务](../tasks/TASK-05.md) · [示例目录](README.md)
|
|
|