先给结论:产品文档改版后,旧文章里需要优先更新的不是所有提到产品的句子,而是那些依赖旧版本才成立、会把读者带向错误操作或错误预期的引用。判断标准只有一条:如果读者照着旧文章继续做,是否会因为改版后的产品文档而得到不同结果。会,就改;不会,可以留。
下面用一个假设场景说明:你手里有一批旧文章,产品文档刚完成一次改版,部分章节被合并、术语被替换、操作路径被调整。你要做的是把每篇旧文章当成一份待检查的资料,而不是先急着改标题或加新段落。
打开一篇旧文章,先把所有与产品文档相关的引用标出来,按依赖程度分成三类:
这个分类的意义在于:你不会因为一次改版就把全部旧文章重写一遍。真正需要投入修改成本的,是强依赖引用;弱依赖引用只需要做术语核对;无依赖引用可以暂时保留。
对每一条强依赖引用,按下面四个字段逐条核对。只要有一个字段对不上,这条引用就需要更新:
假设一篇旧文章写的是“在设置页找到A选项并开启”,改版后A选项被移入高级设置,且默认开启。这时旧文章的问题不是名称错,而是动作已经不需要做。处理方式不是把路径改一遍,而是把这句话改成“该功能默认开启,通常无需手动设置”,并说明在什么条件下才需要进入高级设置。这个动作会直接影响下一步:如果旧文章后面还有基于“手动开启”展开的排查步骤,那些步骤也要一并检查。
不要一上来就全站替换术语。先选一篇强依赖引用最多的旧文章,按新文档改完,然后做两件事:
如果一篇文章改完后,牵出另外三篇文章的引用也要跟着改,说明这批旧文章之间存在引用链。此时更合理的做法是先处理引用链的源头,再处理下游文章;否则你会反复修改同一批句子。反过来,如果改完一篇后没有牵出其他文章,说明这批旧文章的引用是分散的,可以按单篇独立处理。
这里要提醒一个常见误判:某篇旧文章在百度搜索中的展现或点击下降,不能单独证明它需要因为文档改版而更新。下降也可能来自搜索需求变化、竞争内容增加或文章本身时效性减弱。文档改版只是你需要检查的一个原因,不是唯一原因。
这取决于旧说法是否还有读者会用到。两种选择成立的条件不同:
判断依据不是你的偏好,而是旧版本是否还在被实际使用。如果没有依据说明旧版本仍在使用,就不要为了保留而保留;如果确实有过渡期,保留标注比直接删除更稳妥。无论选哪种,都要保证同一篇文章内不混用两套说法。
改完之后,至少记录三列:旧文章标识、被修改的引用类型、修改依据对应的新文档位置。这份记录的作用不是交差,而是让下一次文档改版时,你能快速定位哪些旧文章属于强依赖,哪些可以跳过。没有这份记录,下一次改版你还会从零开始逐篇翻找。
最后回到最初的问题:产品文档改版后,旧文章里需要更新的是那些会让读者照着做却得到不同结果的引用。先分类,再逐条核对操作入口、字段名称、前置条件和结果预期,然后用一篇强依赖文章验证影响面,最后决定保留旧说法还是直接替换。按这个顺序处理,你改的是真正会出问题的地方,而不是所有提到产品的句子。