产品文档改版后,旧文章里最该优先更新的不是所有提到旧版界面的句子,而是那些会让读者据此做出错误动作的引用:失效的路径、被替换的选项名称、已经改变顺序的操作步骤,以及指向旧文档锚点的链接。判断方法不是看文章发布日期,而是看引用是否仍能支撑读者完成同一任务。若旧文章只是提到某个概念,而新版文档仍保留该概念,通常不必为了改版而重写。
常见的情况是,产品文档完成改版后,旧文章的访问量、点击率或站内停留没有立刻变化,于是团队判断“不用动”。但这个现象有两个合理解释。
第一种解释:旧文章里被改版影响的内容本来就少,读者仍能完成任务,因此行为数据没有明显波动。第二种解释:旧文章确实把读者引向了旧路径,但读者在页面上找不到入口后直接离开,或转去搜索其他资料,这种流失未必体现在旧文章自身的点击数据里。也就是说,请求量或点击量没有下降,不能单独证明引用仍然正确。
能区分这两种解释的证据,不是流量曲线,而是引用链路本身:把旧文章中的每一条链接、每一个界面名称、每一步操作顺序,与新版产品文档逐项对照。若链接目标返回错误页、界面名称在新版中已不存在、步骤顺序改变后会导致操作失败,那么无论流量是否下降,都属于需要更新的引用。
可以按“读者是否会据此执行动作”来分层,而不是按文章新旧来排序。
这里的取舍标准是:引用是否承担“指路”功能。指路的引用必须以新版为准;只承担解释功能的引用,改版不是更新理由。
假设某篇旧文章写的是“在设置页点击导出,再选择旧版格式”,而新版文档把导出入口移到了项目菜单,并把格式选项改名为“兼容格式”。这里可以这样取证:
如果第 1 步发现链接失效或锚点偏移,说明引用需要更新;如果第 2 步发现旧名称已不存在,说明名称引用需要更新;如果第 3 步能走通,只是措辞不同,则优先保留原文,避免为了统一措辞而制造无意义改动。这个假设例子的意义在于:判断依据是引用与新版文档的实际对应关系,而不是文章发布时间或访问量。
建议先处理会中断任务的引用,再处理不影响执行的表述。具体动作是:先修失效链接和错误锚点,再改界面名称和步骤顺序,最后才处理“旧版”“新版”这类时间性措辞。这样做的结果是,读者路径先恢复可用,后续再润色文字时不会把已经修好的链接再次改错。
每改完一批引用,应回到旧文章中重新走一遍完整操作。如果走通,说明这批引用可以告一段落;如果仍中断,说明还有未识别的引用,需要回到新版文档继续对照。这个循环比一次性全文重写更可控,也避免把没有问题的段落一起改坏。
把旧界面名称统一替换成新名称,看起来省事,但同义词机械换写不能带来新价值,还可能把解释性文字改成不准确的表述。更稳妥的做法是逐条确认引用承担的功能:它是在指路,还是在解释。指路的引用以新版文档为准;解释的引用只在概念本身变化时才更新。网页标题优化技巧在这里的作用,是帮助你把旧文章中最需要被读者找到的那部分内容保持在可执行状态,而不是追求全文与新文档逐字一致。