先给结论:不要按“文章发布早晚”批量改,而要先锁定改版中被删除、改名或改变含义的实体,再逐条判断旧文章里的引用属于哪一类。只有引用指向的实体本身变了,才需要更新;仅措辞变化或页面位置移动,通常不必动。判断依据是“实体是否仍存在、名称是否仍准确、描述是否仍成立”,而不是旧文章排得靠前还是靠后。
把改版前后的产品文档并排看,只记录三类变化:被删除的条目、被重命名的条目、功能范围发生变化的条目。每一项写清旧称、新称、是否保留、替代页面。这张表是后面所有判断的基准,没有它就容易把“页面搬家”误判成“内容失效”。
假设一个短例子:旧文档里有一个叫“批量导出”的功能,改版后拆成“导出为 CSV”和“导出为表格”两个入口,原页面被删除。差异表里就要记录:旧称“批量导出”,状态为已删除,替代页面是两个新入口。这一步的结果决定下一步——旧文章里凡是提到“批量导出”的链接和描述,都进入待处理清单;只提到“导出”的,先不动。
拿到差异表后,逐篇扫描旧文章,把每处引用归入下面四类之一。分类比逐字替换更重要,因为不同类别的动作完全不一样。
先处理第一类,因为它会直接产生死链或误导跳转。第二、三类可以按文章当前的访问情况排优先级,但不要用“访问量高就先改”替代实体判断——访问量高只说明值得优先投入,不说明引用一定有问题。
这里有一个容易踩的反直觉结果:改版后某些页面的抓取量或站内点击归零,看起来像是旧引用全废了,但归零本身不能证明处理正确。它至少有三种合理解释:页面被暂时下线、导航结构改变导致入口减少、或者统计口径变了。要区分它们,需要看具体证据,而不是看总量。
可核对的证据包括:旧链接实际返回的状态码、替代页面是否存在且内容对应、旧文章正文里的功能名称是否还能在新文档里找到同义项。如果旧链接返回正常、替代页面存在、名称也能对应,那么点击下降更可能是入口变化,而不是引用失效。此时正确动作是修入口,不是改旧文章。反过来,如果旧链接返回错误、替代页面缺失,那才需要动旧文章。
这个判断直接影响下一步:把“链接错误”和“入口减少”分开记录,前者进改稿清单,后者进导航或内链调整清单。混在一起会导致改了一堆旧文章,问题却还在入口上。
处理顺序建议是:先修死链,再改过时名称,最后重写范围变化的描述。每改一处,在差异表里标记对应旧文章和修改日期。这样下一次改版时,你能直接看出哪些文章上次动过、动的是哪一类引用,而不必重新通读。
对于范围变化的描述,不要只把旧词换成新词。要检查整句是否还成立。例如旧句写“在设置页开启批量导出”,改版后入口移到导出面板,那么只换词不够,动作路径也要跟着改。改完后自己按新路径走一遍,确认描述和实际界面一致,再进入下一篇。
如果一篇旧文章引用的是长期稳定的概念、流程原则或与本次改版无关的模块,并且链接有效、名称未变,就不必为了“统一”而动它。机械换写同义词不会带来新价值,反而可能引入新的不准确。把精力集中在差异表里有记录的实体上,比全站扫一遍更可靠。
最后回到你手里的那张差异表:先确认它覆盖了删除、改名、范围变化三类,再按引用类型逐条处理,并用链接状态和替代页面是否存在来验证判断。做完这一轮,你会得到一份可复查的更新记录,而不是一堆改过却说不清为什么改的旧文章。