旧教程不必因为功能改名就整篇重写,但必须把“名称”和“动作”拆开处理:凡是只出现旧名称、却没有描述点击后发生什么的内容,都会在改名后失去可理解性;凡是写清了操作路径、判断依据和结果表现的内容,通常只需补一行新旧名称对照。判断标准不是教程发布时间,而是读者能否在不认识新名称的情况下,仍然知道下一步该做什么。
改名初期常出现一种情况:你自己按旧流程操作,发现入口还在、跳转也正常,于是判断教程不用动。但把同一批教程交给不同人执行时,问题才暴露——有人找不到入口,有人点进了另一个功能,有人把新名称当成新工具重新学习。个别样本成立,是因为你熟悉旧名称到新入口的映射关系;规模化后出现例外,是因为读者没有这层记忆。
这意味着“我这边还能用”不能作为保留旧教程的依据。真正需要验证的是:一个只读过教程、没有旧名称记忆的人,能否独立完成同一串动作。如果答案是否定的,教程的可理解性已经受损,只是受损点被你的熟悉度掩盖了。
旧教程失效通常有两种原因,处理方式完全不同。
把这两种情况混为一谈,就会出现两种错误:要么把只是改名的教程整篇废弃,浪费已有内容;要么把能力已经变化的教程只改个名字,让读者按旧预期操作却得到不同结果。
不要靠名称相似度判断,要靠动作链。把旧教程里的每一步写成“触发动作 → 预期反馈”,然后逐条在新环境中核对。
假设某篇旧教程写的是“进入A功能,勾选B选项,保存后生效”。改名后你发现入口叫C,但进入C后仍然有B选项,保存后的反馈也相同,这就是解释一。反过来,如果进入C后B选项消失了,而是要在另一个位置先做一次选择,保存后反馈也延后出现,这就是解释二——此时只做名称替换会误导读者。
这里要说明一个边界:入口还能打开、页面还能跳转,不能单独证明教程仍然正确。页面可达只说明链接没断,不说明旧教程描述的动作顺序和判断依据仍然成立。同理,某段时间内来自旧教程的点击量下降,也不能直接归因于改名,还可能是读者来源结构变化、教程本身位置变化或季节性波动。要确认改名影响,需要回到动作链逐条核对,而不是看单一指标。
确认属于解释一的教程,最小改动是在旧名称首次出现的位置补一行对照,并说明“以下步骤按新名称执行”。这一行动的结果是:老读者能凭旧称找到位置,新读者不会被旧称卡住,后续步骤无需改动。
确认属于解释二的教程,不能只加对照。需要做三件事:
如果同一批教程数量较多,可以按动作链核对结果分三类处理:动作完全一致的只加名称对照;动作顺序变化的补步骤说明;动作结果性质变化的单独重写该段,并在段首标明适用条件。这样做的结果是,读者不需要先判断教程新旧,就能在执行过程中自行确认走的是哪条路径。
最后要接受一个现实:改名后的可理解性不来自名称统一,而来自每一步都有可观察的反馈。只要教程能让读者在动作之后知道自己是否走在正确路径上,旧名称就只是一个需要翻译的标签,而不是必须删除的内容。