先不要按“出现旧版本号”来筛,而要按引用是否依赖被改动的具体事实来筛。产品文档改版后,旧文章里真正需要动的通常只有三类:引用了已改名或已下线的功能、引用了改版后含义变化的术语、以及把旧版操作步骤当成前置条件的段落。其余只是提到产品名或泛泛链接的句子,可以留到下一轮再处理。
改版方通常只给出一份变更说明,但旧文章是否受影响,取决于变更说明里哪些条目会改变读者对事实的理解。让改版负责人和内容负责人各写一版清单,再逐条对齐,分歧点就是后续要核对的引用位置。
清单建议只保留三类字段:旧表述、新表述、影响范围。影响范围写“术语”“流程”“入口名称”或“数据口径”,不要写“全部相关文章”,否则无法落地。假设某功能从“批量导入”改名为“数据同步”,影响范围就记为术语;如果导入入口从设置页移到项目页,影响范围记为流程。两者对应的旧文章处理方式不同。
同一篇旧文章里,不同句子的引用强度不一样。可以按下面四类判断,处理顺序也按此排列:
做完这一步,你会得到一份“句子级”待处理清单,而不是“文章级”清单。下一步的排期和分工都依赖它。
多个角色对同一事实理解不同时,争论“读者会不会误解”没有终点。把分歧转成可核对的项目:截图、变更说明条目、新文档里的原句、旧文章里的原句。四方对照后,只回答一个问题——旧句是否与当前事实冲突。
例如,运营认为旧文章里的“支持导出全部数据”仍然成立,产品认为导出范围已缩小。核对方式不是投票,而是找到新文档中描述导出范围的句子,与旧句并列。如果新句限定了范围,旧句就进入待改队列;如果新句只是换了措辞、范围未变,旧句可以标注“暂不改”并记录理由。这个动作的结果会直接影响下一步:进入待改队列的句子需要排期,标注暂不改的句子不再占用改版窗口。
假设某产品文档把“工作区”改名为“项目”,并把成员权限从两级改为三级。旧文章 A 里有一句“在工作区设置中添加成员”,旧文章 B 里有一句“本产品支持多人协作”。
如果只按“文章里有没有出现工作区”来筛,文章 B 可能被误改;如果只按“文章新旧”来筛,文章 A 里的权限变化又可能被漏掉。按句子级引用类型筛,两类错误都能减少。
改完不是结束。拿最初的“被改动事实”清单,逐条回到旧文章里找对应句子,确认三种状态:已改、确认无需改、仍待确认。仍待确认的条目要写清卡在谁那里,而不是笼统标注“待定”。
如果某条引用在清单里找不到对应句子,说明前一步的扫描范围可能漏了页面,需要补扫,而不是直接判定无需处理。这个反向验证动作决定下一轮是收尾还是继续排查。