先给结论:旧文章里需要更新的不是所有提到产品的句子,而是那些把旧文档当作“唯一依据”的引用。判断标准可以落在一张表上——列出旧文章中的引用点,逐条标注它依赖的是产品事实、操作步骤还是概念解释,再对照改版后的文档确认该事实是否已变。依赖已变事实的引用必须改;只借文档做背景说明、且事实未变的引用可以留;指向已删除或更名的文档链接则必须换或删。
产品文档改版后,旧文章里通常混着三类引用,处理方式完全不同。第一类是事实引用,比如参数、字段名、权限规则、版本差异;第二类是操作引用,比如“按文档第几步配置”;第三类是解释引用,比如用文档里的定义帮助读者理解概念。前两类对文档变化敏感,第三类往往不敏感。
可执行动作:打开旧文章,把每一处提到文档的地方摘出来,填进一张四列表——文章URL、引用原文、引用类型、对应的新文档位置。填表时不要凭印象判断“应该没变”,要真的打开新文档核对。这个动作的结果会直接决定下一步:清单里标注“事实已变”的条目进入必改队列,标注“文档已删除或更名”的进入链接处理队列,其余先不动。
面对改版,常见的两种取舍是“趁改版把旧文章整体重写一遍”和“只动受影响的引用点”。两者都成立,但适用条件不同。
判断依据可以是一个比例:如果受影响引用点占全文引用的一半以上,重写更划算;低于这个比例,逐条替换更快。这个比例只是帮助比较的假设方法,不是固定阈值,实际以文章能否继续自洽为准。
文档改版常伴随页面删除、合并或改地址,旧文章里的链接要分情况处理,不能一律替换成首页。
这里有一个容易忽略的验证动作:改完链接后,逐条点开确认目标页确实包含你引用的那条事实。如果目标页只是相关但不包含该事实,读者点过去会扑空,这类“看似修好”的引用仍算失效。
假设某篇旧文章写“在设置页开启自动同步后,数据会每小时上传一次”,而新版文档把同步改为手动触发,并删除了“每小时”的说法。按前面的清单:这句属于事实引用,对应新文档位置已变,进入必改队列。改法不是删掉整段,而是把“每小时上传”替换为新文档的准确表述,并保留“开启同步”这一仍然成立的操作前提。改完后,文章其余部分不需要动。
反过来,如果旧文章只是用文档里的一个定义解释某个概念,而该定义在新版中措辞微调但含义未变,那么这条引用可以保留,最多把用词对齐。这个例子的意义在于:同样是“文档变了”,事实引用和解释引用的处理代价差别很大,先分类再动手能省掉大量无效修改。
完成修改后,用两个动作收尾。第一,回到引用点清单,逐条确认状态已从“待处理”变为“已改”或“确认保留”,没有悬空条目。第二,把清单里“确认保留”的条目再抽查一遍,重点看那些依赖旧文档措辞的句子是否仍与新版一致。如果抽查中发现新的不一致,说明第一轮分类时把事实引用误判成了解释引用,需要回到清单补充。
需要提醒的是,改版后旧文章的访问量或抓取量出现波动,不能单独证明你的引用处理正确或错误。波动还可能来自改版本身的收录调整、其他页面变化或外部因素。所以判断依据应回到引用点与新文档的一致性,而不是把某项统计的变化直接当成处理结果。按清单逐条核对、按类型决定改或留,才是可复用的处理方式。