结论先说:如果旧版说明仍能解释读者当下会看到的现象,就保留并标注适用条件;如果它描述的是已经失效的入口、数值或操作路径,就应改写或移入历史备注,而不是原样留着。判断标准不是文章新旧,而是旧说明是否还在指导当前动作。
第一种条件:旧版说明描述的是历史概念。例如早期围绕搜搜竞价留下的指标口径、快照式数据或第三方仿值,它们本身属于特定时期的产物。这类内容可以保留,但要在段首写清它对应哪一类历史语境,并说明今天不能直接拿来做投放或结算依据。
第二种条件:旧版说明描述的是可执行动作。例如某个后台入口、字段位置、报表路径。这类内容一旦与当前界面不一致,保留原文就会让读者按错误路径操作。此时应替换为当前可用动作,或把旧路径压缩成一句历史备注,避免它继续承担教程功能。
区分这两种条件,比争论“旧内容要不要删”更有用。保留的是解释力,替换的是操作指令。
更新前,对旧文里每个具体说法做一次核查,按下面三类标记:
这个动作的结果会直接决定下一步:标记为“部分成立”的段落需要重写,标记为“已失效”的段落需要决定是删除还是降级为注脚。两者不能混在一起处理,否则读者分不清哪句还能照着做。
假设旧文里有一段写“用某公开 PR 值判断页面质量”。这里的 PR 值属于历史概念,且第三方仿值与官方数据不是一回事。处理方式不是把数字更新成新数字,而是改成:说明该指标在历史上被用来做什么、它不能替代什么判断,并提示读者不要把它当成现行标准。
再假设旧文写“在某个报表页点击某按钮导出数据”。如果该按钮位置已变,保留原文会让读者找不到入口。此时应把动作改写成当前可验证的路径,或者直接删掉这一步,只保留“导出后要核对哪些字段”的判断方法。动作会过时,判断方法不容易过时。
个别样本成立,不等于可以批量照搬。批量替换旧版说明时,常见的例外有三类:
遇到这三类例外,处理动作要改成“加标注”而不是“直接替换”。这样做的结果是:旧读者能对上原文,新读者也不会被误导。
把更新拆成四步,每步都有明确产出:
完成后再通读一遍:如果读者只看保留的段落,能不能知道哪些能照做、哪些只能当背景。如果不能,说明标注还不够清楚,需要继续改。
旧版说明值得保留,前提是它仍在帮助读者理解某个现象,而不是在提供已经走不通的操作。反过来,只要一段话会让读者去点一个不存在的入口、去查一个已经变质的数值,它就应该被改写或移走。这个边界不靠文章发布时间判断,靠每个具体说法当前是否还成立判断。