是否保留旧版说明,取决于旧说明现在承担什么角色。如果它记录的是某个历史阶段的操作前提、工具状态或合作条件,而且读者仍可能遇到那批旧内容,就应保留但降级为时间标注的存档;如果它只是已经失效的入口、价格或承诺,继续留在正文主路径只会制造误判,应改写为历史注记或直接退出。判断标准不是“旧不旧”,而是“读者今天照做会不会做错”。
把旧段落逐句过一遍,问它属于哪一类:
史料型可以留,但必须让读者一眼看出它属于过去;指令型一旦失效,留在原位就是风险。一个实际动作是:给每段旧说明加一行时间前缀,例如“以下为当时做法,现已不代表现行流程”。做完这一步,再回头看哪些段落加了前缀仍然别扭——那些通常就是该退出的部分。
有些旧内容不能删,因为删掉后新读者会看不懂后文。典型情况是文章里出现了旧术语、旧系统名称或旧合作关系,而后续段落仍在引用它。此时保留旧版说明的价值在于“解释来源”,而不是“提供方法”。
适用前提有三个:旧说明与当前内容存在因果或对照关系;读者可能从外部旧链接进入这篇文章;删除后会造成上下文断裂。三个都成立时,保留并标注时间,比整段删除更稳妥。假设某篇旧文写的是“当时通过某历史指标判断页面更新频率”,这个指标今天已不适合作为依据,但文章后文一直在用它举例。此时保留一句“该指标为当时语境下的参考,现已不作为判断依据”,读者才能理解后文在说什么。这是假设例子,用来说明保留与改写的分界,不是真实项目记录。
更多时候,旧说明的问题不在结论,而在路径。结论仍然成立,但当年的入口、名称、合作方式已经变化。这时不要保留原文再补一句“已失效”,而应把旧说明改写成条件句:
改写后要检查一件事:新读者只读改写后的段落,能不能独立理解结论;旧读者回来找当年那句话,能不能在注记里找到。两个都能,说明改写到位。只满足前者,旧读者会认为内容被抹掉;只满足后者,新读者仍会被旧指令带偏。
以下情况适合直接退出,而不是保留加注:
退出不等于悄悄删掉。更稳的做法是在文末或相关段落留一句范围说明,例如“本文已移除早期版本中关于某历史做法的操作描述,因其不再适用于当前判断”。这句话的作用是给回访读者一个交代,也避免旧链接进入后找不到任何对应信息。注意,这里不需要断言某个具体服务或工具现在是否存续;你只需要说明本文为什么不再保留那部分内容。
按下面顺序处理,能减少反复:
做完这一步,你会得到两种结果:一种是旧说明被保留但不再具备指令性,另一种是旧说明退出正文、只在范围说明里被提及。两种结果都会影响下一步——如果保留的注记仍然让读者困惑,说明它应该继续降级或退出;如果退出后旧链接读者完全找不到上下文,说明需要补一句范围说明而不是恢复原文。判断依据始终是读者今天照做会不会错,而不是旧内容本身是否曾经正确。