先给有条件的结论:只有当旧文章里的引用会改变读者对当前产品能力的判断时,才需要更新;如果引用只是背景说明、历史沿革或已下线功能的归档记录,可以保留,但要在文中标明时间或状态。这个判断成立的前提是,你能把“事实变了”和“措辞旧了”分开核对。下面把分歧转成可核对的项目。
产品文档改版后,旧文章里的引用通常混着三种东西:能力描述、操作步骤、名词叫法。三者的更新条件不同。
把这三类分开后,你会发现需要动的往往不是全部旧文章,而是那些会被读者当作“当前事实”来用的段落。
一个可操作的筛选方法是:读完旧文章里的这句引用,读者下一步会做什么?如果下一步动作依赖这个引用,而引用已经和改版后的文档不一致,就更新。如果读者下一步只是了解背景,不执行操作,可以暂缓。
假设你有一篇旧文章写“导出前需要先创建分组”,而改版后的文档写“导出时可直接选择标签,无需预先创建分组”。这句话会直接改变读者的操作顺序,属于必须更新。反过来,旧文章里写“本功能最早在某个版本出现”,改版后功能仍在,只是入口变了,这句话不影响操作,可以保留。
这里要提醒一个反例:如果旧文章里的引用虽然措辞旧,但读者读完仍会去查最新文档,且文章本身已经标注“以产品内文档为准”,那么不更新未必造成误导。反过来说,即使引用只是名词叫法不同,但旧叫法会让读者在搜索框里搜不到对应入口,这种“叫法差异”也会变成操作障碍,仍应更新。
多个角色对同一事实有不同理解时,不要争论“该不该改”,而是把分歧落到可核对的条目上。产品角色关心能力边界,支持角色关心读者会不会问错问题,内容角色关心旧文章是否还被搜索到。三方可以共同确认下面这张表。
核对表的作用是让“我觉得要改”变成“第 3 条能指出卡住的位置”。如果某个角色无法指出具体卡点,只说明措辞不好看,可以排到低优先级。
旧文章里的引用往往不是孤立一句话,它可能带着内链锚文本、图片说明或代码示例。只改正文句子,不改锚文本,读者仍可能点到旧页面。一个实际动作是:先定位旧文章中所有指向被改版文档的链接,再逐条判断锚文本是否还准确。
例如旧文章里写 <a href="/old-doc">分组管理</a>,改版后文档标题已变成“标签管理”。如果你只改正文,不改锚文本,读者点击后看到的标题和锚文本不一致,会怀疑自己点错。把锚文本一起改成“标签管理”,并确认目标页面仍可访问,这个动作的结果会直接影响下一步:如果目标页面已迁移,你需要先处理跳转或替换链接,再改正文。
以下条件同时成立时,旧文章可以暂不更新:文章明确标注了适用版本或日期;文中引用不会被读者当作当前操作依据;文章的主要价值是记录历史决策或旧版界面。只要其中一条不成立,就回到核对表重新判断。
最后一步动作:挑一篇旧文章,把其中所有引用当前产品能力的句子标出来,逐句问“读者按这句做,下一步会不会失败”。会失败的,进入更新清单;不会失败的,标注保留原因。这样你得到的不是一份“全部重写”的焦虑,而是一份能解释为什么改、为什么不改的清单。