先给结论:产品文档改版后,旧文章里需要更新的不是所有提到旧文档的地方,而是那些会让读者按图索骥却走错路、或让页面事实与新版文档冲突的引用。判断依据是引用承担的功能,不是它出现的位置。下面用一个假设情境把决策过程拆开。
假设某个产品把原来的“设置指南”拆成了“账号设置”和“通知设置”两篇新文档,旧文档地址保留但内容已重定向到新文档首页。编辑、产品经理、客服对旧文章里一句“详见设置指南”产生了分歧:编辑认为链接还能打开就不用改;产品经理认为指向的层级变了,等于失效;客服认为读者真正想问的是通知开关在哪,旧文章没写清楚。
这三种理解都成立,但对应的是不同问题。把它们转成可以核对的项目,就能避免反复争论:链接是否还能落到读者预期的那一页、正文描述是否与新版文档的术语一致、读者读完旧文章后能否完成原本要做的动作。
把旧文章里的引用逐条过一遍,先问它在句子里干什么。功能不同,处理方式不同。
分类之后,动作就很具体:先标出导航型和定义型,再核对证据型,最后处理补充型。这样做的结果是,更新范围从“整篇重写”缩小到几条真正影响读者动作的引用,后续排期和验收也有了明确对象。
分歧之所以难收敛,是因为双方都在用感觉说话。转成可核对的项目后,判断会稳定得多。以下每一条都可以在编辑和产品之间直接对照:
如果第2步的落点与第1步的预期不符,这条引用必须处理;如果一致,再看第3步。第3步不一致但落点正确,属于术语同步问题,改动量小。第4步缺失,则要决定是补内容还是删掉这句承诺——这个决定会影响旧文章是否还值得保留。
引用更新完,不等于旧文章就该继续存在。改版后常见的情况是:旧文章的主题已被新文档完全覆盖,只是措辞和角度不同。这时更新引用只是延长了一篇重复内容的寿命。
可以这样区分:如果旧文章解决的是“读者在什么场景下会问这个问题”,而新文档解决的是“功能怎么用”,两者角度不同,旧文章仍有价值,更新引用即可。如果旧文章只是把新文档的步骤换了个说法,那它带来的就不是补充,而是同一事实的多个版本,日后改版还会再次产生分歧。
做这个判断时,不要用“页面还能不能打开”当依据。链接可访问、抓取正常、页面有展示,都不能单独说明它该保留——这些现象同样可以由缓存、历史外链或读者直接搜索标题来解释。真正的依据是它是否提供了新文档没有的回答角度。
假设情境里的三个人最后可以这样做:编辑把旧文章里所有引用列成一张清单,每条标注功能类型和预期落点;产品经理只核对导航型和定义型两类,确认新版文档是否有对应内容;客服提供读者最常问的那一个问题,用来检验旧文章更新后能否直接回答。三方对同一张清单负责,分歧就变成了逐条勾选。
这个动作的结果会直接决定下一步:清单上落点不符的条目进入修改队列,内容缺失的条目进入补写或删除决策,术语不一致的条目做统一替换。剩下的引用保持不动,也不需要为了“看起来更新过”而改动。这样处理之后,旧文章与新版文档各司其职,读者不会因为一句引用被带到与预期不符的地方。