2.3 KiB
2.3 KiB
TASK-05 重组章节与导航
适用:整本书逻辑不连贯、单章过长、定义重复、分章粒度不合适或检索困难。
必读:信息架构、DOC-005、DOC-006、DOC-007、DOC-008、DOC-021、DOC-024。
找出具体结构问题
为现有小节标注读者问题、前提和主定义。找出四种情况:使用早于定义;同一规则有多个版本;一页混合不同读者任务;某页只能靠聊天解释。
标题数量或文件行数只能提示风险,不能决定拆分。先用一个读者任务走查现有路径,记录卡住的位置。
设计目标结构
保持清楚的学习主线,并给术语、语法和任务查询入口。目录标题应能说明内容,不要求所有分支数量对称。
为移动内容制作映射表:原路径/小节、目标路径/小节、保留的主定义、需要更新的引用。示范见EX-05。文件名和 DOC/SRC/TPL 稳定 ID 分开处理;移动规则不能重用已存在的编号。
实施顺序
先建立目标页的职责与内容,再更新入站链接、目录与相邻导航,最后处理原页。移动时保留重要约束和局部假设,不因归入附录就删除读者使用时需要的提示。
用户要求实际移动文件时选择符合版本控制的操作,检查已有未提交修改。站外分享链接可能无法全量检索;需要保留兼容入口的情况,应明确记录实际措施与未覆盖范围。
交叉检查
正文编号、首页目录、上一章/下一章、术语索引、规范状态、文法链接和作者手册引用都可能受影响。用旧路径及旧标题搜索引用,核对每一类命中。
结构重组原则上不更改语言断言;发现矛盾时记录并按 TASK-06 处理,而不是将某一版本悄悄消失。
验收
从首页顺读、从术语跳入、从引用返回主定义,各走一条与本次修改相关的路径。新位置能独立说明主题,旧引用没有指向错误内容。
交付映射和理由,说明新增、移动、合并或删除的文件以及相应导航更新。