先直接回答:产品文档改版后,旧文章里真正需要更新的不是所有提到产品的句子,而是那些会让读者按图索骥却走错路的引用。判断标准只有一条——读者照着旧文章里的说法去操作,是否还能得到和改版后文档一致的结果。如果会得到错误结果,就必须更新;如果只是名称变了但路径和结论没变,可以暂缓。下面以你手里的一篇旧文章为例,逐步拆成可执行的处理方案。
把旧文章复制到一个临时文件里,逐段标出所有指向产品文档的位置。你会发现它们大体分三类:
三类里,路径引用和结论引用必须优先核对,概念引用可以放到第二批。这样分类的意义是:你不必通读全文重写,只需盯住会误导操作的部分。
假设你手里有一篇讲“如何导出数据”的旧文章,文中写“打开产品后台,点击左侧数据管理,选择导出”。改版后文档把入口挪到了顶部工具栏。你按旧文章走一遍,会在左侧找不到入口,这就是必须更新的信号。
这个动作的结果直接决定下一步:走不通的引用,改文字或改指向链接;走得通但表述过时的,只改措辞;走得通且表述一致的,不动。不要因为文档整体改版就批量替换所有链接,那样会浪费精力,还可能把原本正确的指向改错。
面对几十篇旧文章,常见两种做法:
选择条件取决于两点:旧文章的访问来源是否仍以搜索和推荐为主,以及改版是否改变了核心操作流程。如果改版只是界面微调,定点修补足够;如果核心流程变了,比如注册、支付、权限设置,那么相关旧文章即使访问量不高,也应按全量重写处理,因为错误操作会带来实际损失。
定点修补做完后,还有三处容易漏掉:
这三种残留不会因为正文改完就自动消失,需要单独列一张清单逐项确认。
假设旧文章讲“如何开启双重验证”,文中写“进入账户安全页,找到开关”。改版后文档把该功能移到了“登录与安全”分组。你按旧路径走不通,于是有两个选择:改文章里的路径描述,或者把文章里的步骤删掉、只保留概念说明并链接到新文档。
如果这篇旧文章仍有搜索流量,且读者需要看到完整步骤,就改路径描述;如果它只是作为概念解释存在,删掉步骤、引导读者看新文档更省维护成本。两种做法都成立,区别在于你愿意承担多少后续同步工作。改路径描述意味着下次文档再改,你还要再改一次;引导到新文档则把维护责任交回文档本身。
做完这一步后,把改动记录到一张更新表里,注明改的是哪类引用、依据是新文档的哪个位置。下次文档再改版时,这张表就是你的核对起点,而不是重新通读所有旧文章。