1.3 KiB
1.3 KiB
DOC-006 按读者问题分页
分类：结构与导航。级别：核心。本规则是项目写作约定，不是语言语义。
规则
一页承担一个主要主题或任务；按独立查阅需要拆分，而不是按固定字数或每句话拆分。
原因
好的边界既支持定位，也保留理解当前主题所需的上下文。
执行方法
- 可以独立命名和查阅的内容单列页面。
- 类型声明与取得数据是不同问题；类结构和数据读取分别成章。
- 短而紧密依赖的子项保留在同页，避免制造大量空壳或跳转。
改写对照
问题写法：把所有类声明、读取、界面更新和失败方案放在同一章。
推荐做法：将结构、读取和渲染分开，并在使用点连接。
以上是说明写作差异的项目例子，不新增语言能力。
验收
- 页名说明主题，不叫“更多”或“其他”。
- 拆分页仍可独立阅读。
- 没有仅因字数达到阈值而拆分。