先给结论:不要按“旧文章发布时间”批量重写,而要把每篇旧文里指向产品文档的引用逐条找出来,按“链接是否还能打开、引用的字段或步骤是否已变、这句话离开原文后是否还成立”分成三类,只改后两类。链接能打开但内容已变的引用,往往比死链更危险,因为它让读者按旧步骤操作,也让搜索引擎继续把旧语义和你的页面绑定。
打开旧文章,把所有指向产品文档的位置标出来,包括超链接、括号里的文档名称、截图下方说明、代码注释里的路径,以及“详见某文档”这类没有链接的纯文字。对每条记录四项:所在文章、引用形式、目标文档当前状态、这句话是否依赖具体字段或步骤。假设你手上有 40 篇旧文,其中 12 篇提到过同一个配置项,清单会让你看到改动集中在少数几个文档,而不是 40 篇都要动。
这一步的实际动作是:先只记录,不改稿。结果会直接决定下一步——如果某篇旧文里的引用全部指向已废弃文档,那它需要的是替换或删除,而不是润色。
产品文档改版后,最常见的状态是 URL 没变、页面还在,但字段名、默认值、操作顺序或权限说明已经不同。旧文章里“在设置页勾选 A 选项”这类句子,链接依然能打开,读者却找不到 A。判断方法很简单:点开链接,看旧文提到的名词是否还出现在文档里。如果名词消失或换了位置,这条引用就要更新,至少改成新名词,必要时补一句“旧版本叫 A”。
另一种情况是文档把原来的一页拆成了多页。旧文只链到其中一页,读者看不到前置条件。这时不要只换链接,要在旧文里补一句前置条件,或者把链接指向新的总览页。代价是旧文的段落会变长,收益是读者不会在半路卡住。
如果旧文只有一两处引用失效,就地替换链接和名词即可,改动小、风险低。如果一段话的论证依赖旧文档里的三个步骤,而新文档已经改成两步或换了入口,那就重写这一段,因为逐词替换会留下逻辑断裂。判断条件可以这样用:改动只涉及名称和地址,就地改;改动涉及顺序、前提或结果,重写。
重写的代价是你要重新核对整段是否还和其他段落一致,比如前文说“先配置再发布”,新文档改成“先发布再配置”,那前文也要一起改。就地改的代价是可能留下旧名词的残影,读者搜不到。两种做法都成立,区别在于这段引用是否承担了操作说明的职责。
假设旧文里有一句:“在项目设置中打开同步开关,然后回到列表页刷新。”改版后文档把同步开关移到了“集成”页,并且刷新改为自动。这条引用属于“步骤已变”,应重写为:“在集成页开启同步,列表会自动更新。”如果旧文只是说“相关设置见项目设置文档”,而文档只是换了标题,那就只改链接文字和地址。这个例子里的数字和页面名称都是假设,用来演示判断顺序,不代表任何具体产品。
动作和结果的关系在这里很直接:你按“是否依赖步骤”分类后,重写量会明显小于按“是否死链”分类,因为死链只是失效的一种,步骤错位不会报错,却会让读者停在原地。
更新完引用后,不要立刻认为任务结束。回到旧文开头,确认它回答的问题是否还和当前产品一致。如果旧文的主问题已经不存在,那更新引用只是延长了一篇不该继续存在的文章的寿命,这时更合适的动作是合并到新文档或标记为过时。如果主问题还在,只是细节变了,那更新引用就足够,下一步是检查这篇旧文是否还有内部链接指向它,避免读者从其他页面进入后看到半新半旧的说明。
最后,把这次改动记在旧文自己的更新说明里,写清改了哪类引用、依据是哪份文档的哪一版。这样下次文档再改版时,你能快速判断哪些旧文需要复查,而不是重新从零开始找引用。