核心判断是:旧教程不必整体废弃,但也不能原样保留。只要教程里出现的是平台功能名称、入口路径或后台按钮,就必须区分“名称变了”和“功能变了”两种情况。前者适合加注保留,后者适合改写或退出。保留的前提是读者仍能把旧名称对应到当前操作;如果对应关系已经断裂,保留只会增加误操作。
平台功能改名后,旧教程的可理解性通常在三层受损。第一层是名称层:功能还是同一个,只是叫法换了。第二层是路径层:名称没大变,但入口位置或操作步骤变了。第三层是对象层:原功能被拆分、合并或取消,旧教程描述的对象已经不存在。
区分方法很直接:拿旧教程按当前后台走一遍,记录卡在哪一步。如果只是找不到旧名称,但按新名称能完成同样动作,属于名称层;如果必须换一条路径才能完成,属于路径层;如果无论如何都完不成原来的目标,属于对象层。这个判断决定了后面是加注、改写还是下线。
名称层变化时,保留原文并加一条显眼的对应说明,通常是成本最低的做法。适用前提是:旧教程的步骤顺序、判断标准和结果仍然成立,只是按钮或菜单换了叫法。此时读者需要的是“旧词到新词”的映射,而不是重写一篇新教程。
实际动作可以这样设计:在旧教程开头加一段改名对照说明,写明“文中提到的旧名称,在当前后台对应新名称”,并在首次出现旧名称的段落旁补一句当前叫法。做完这一步后,去后台按教程走一遍,确认每一步仍能完成。如果走通了,这篇教程可以继续保留;如果走到某一步发现操作逻辑也变了,就应升级为改写,而不是继续堆加注。
这种做法的代价是维护成本会累积。同一篇教程里如果出现多个旧名称,加注会越来越长,读者需要在正文和说明之间来回跳。因此它更适合旧教程数量少、名称变化集中、且短期内不会再改的情况。
路径层变化时,加注已经不够。旧教程的步骤顺序可能整体失效,读者按旧顺序操作会卡住。这时应改写正文,把旧路径替换为当前路径,并保留原来的判断逻辑,比如什么条件下该投、什么条件下该停。
改写不是把旧词批量替换成新词就结束。更稳妥的做法是:先按当前后台重新走一遍完整流程,把每一步的实际动作记下来;再对照旧教程,删掉已经不存在的步骤,补上新增的步骤;最后检查教程里的判断标准是否还成立。假设一篇旧教程写的是“先进入某个推广设置页,再选择投放目标”,而当前流程变成了“先选投放目标,再进入设置页”,那么只改名称不改顺序,读者仍会迷路。
改写的代价是需要重新验证。验证动作包括:按改写后的步骤完整操作一次,确认每一步都能到达预期位置;检查文中提到的数据口径是否仍与当前后台一致。如果验证不通过,说明变化已经不止路径层,应进入退出判断。
对象层变化时,旧教程描述的功能可能已被拆分、合并或取消。继续保留会误导读者,继续改写则等于重写一篇新文章。这时更合理的选择是退出:把旧教程下线、设为归档,或者改成一篇说明“该功能已调整,请参考当前后台”的短提示。
退出的前提是确认旧功能确实不再以原来的方式存在。判断依据不能只看名称消失,还要看原目标是否还能通过其他路径完成。如果原目标仍能完成,只是换了入口,那属于路径层,不应直接退出。只有原目标无法按旧方式完成,且改写成本高于重写成本时,退出才成立。
退出的代价是失去旧教程原有的访问入口。如果旧教程仍有一定访问量,直接删除会让读者落到空白页。更稳妥的做法是保留一个简短说明页,告诉读者功能已调整,并指向当前可用的操作路径。这个动作的结果是:读者不会按旧步骤误操作,同时你也不需要继续维护一篇已经失真的长教程。
这套顺序的关键在于:先确认旧教程坏在哪一层,再决定保留、改写还是退出。名称变化不等于功能失效,路径变化不等于必须重写,功能消失也不等于只能删除。把这三层分开判断,旧教程才能在平台改名后继续被读者理解,而不是变成一份看起来还在、实际已经走不通的说明。