先给结论:不是所有提到旧文档的句子都要改,真正需要动手的是那些会让读者点进去后找不到同一结论、同一参数或同一步骤的引用。判断标准只有一条——旧文章里的引用是否还承担“替读者确认事实”的功能。如果它只是举例带过,可以不动;如果读者会顺着它去操作,就必须更新。
产品文档改版后,旧文章里的引用大致分两种。导航型引用是“详见某文档”“参考某说明”,读者点进去是为了继续操作;证据型引用是“根据某文档,这个参数是……”,读者不点进去也能读完,但一旦点进去发现对不上,就会怀疑整篇文章。
两种引用的处理方式不同。导航型引用只要目标位置变了,就必须改,否则读者卡在半路。证据型引用要看结论有没有变:文档结构改了但结论没变,可以保留文字、只换位置;结论本身改了,就必须连同旧文章里的判断一起改。
这是最常见也最容易被过度处理的情况。文档换了目录、拆了章节、改了标题层级,但参数、步骤、限制条件都没动。此时旧文章里那些“证据型”引用不需要重写句子,只需要把指向更新到新位置。
具体动作可以这样安排:先列出旧文章中所有指向该文档的链接和文字提及,再逐一打开新版文档,确认对应结论是否仍在。仍在的,只改指向;找不到对应结论的,标记为待处理,不要先改文字。
这里有一个容易漏掉的条件:如果旧文章把文档标题写进了正文句子,比如“在《某某操作手册》中”,而新版已经改名,那么即使结论没变,这句话也会让读者搜不到。标题变更属于必须同步的引用,不能只改链接。
这种情况不能只做链接替换。旧文章里凡是引用被删章节来支撑判断的句子,都要重新确认:这个判断现在还有没有依据?如果没有,就要删掉或改写,而不是把链接指向一个近似的新章节。
一个假设例子:某篇软文推广案例写到“按旧版说明,素材提交后需要人工复核”。新版文档删掉了人工复核这一步,改成系统自动校验。旧文章如果只把链接换到新版首页,读者点进去找不到“人工复核”,会认为文章过时;正确做法是把这句话改成新版的实际流程,或者删去这一句,改用其他仍成立的依据。
执行顺序建议是:先处理结论已变的引用,再处理仅位置变化的引用。因为结论变化会影响句子本身,先改句子能避免后面重复劳动。
不是所有提及都要跟进。以下情况可以保留:引用只出现在举例、背景铺垫或延伸阅读里,读者不依赖它完成操作;引用指向的是长期稳定的概念说明,而非具体参数或步骤;旧文章本身已经标注了适用版本,且读者能看出这是历史说明。
但要注意,判断“可以不动”不能只看引用出现的频率,也不能因为某篇文章流量低就跳过。流量低只说明关注的人少,不说明引用不会误导留下来的读者。是否处理,取决于引用是否承担确认事实的作用,而不是数据表现。
把旧文章中所有指向该文档的引用集中到一张清单,逐条标注三件事:引用类型(导航型或证据型)、新版是否仍有对应结论、旧文章句子是否依赖该结论。标注完成后,按“结论已变→仅位置变→可保留”的顺序处理。
这个动作的结果会直接决定下一步:如果清单里“结论已变”的条目很少,说明这次改版对旧文章的影响有限,可以只做局部替换;如果这类条目集中出现,说明旧文章对该文档的依赖较深,需要安排一次成批更新,而不是零散修补。