如果旧教程里的功能名称已经和当前界面不一致,先不要整篇删除,也不要只做一次全局替换。更稳妥的做法是判断“旧名称是否仍能被读者对应到新功能”:能对应上的,保留原文并补一行新旧对照;无法对应、且教程步骤已经走不通的,才改写或退出。判断依据不是名称变了多久,而是读者照做时是否会在关键步骤卡住。
把旧教程按“读者能否自行完成目标动作”分成三类,处理方式不同:
这三类的分界不是文章新旧,而是“读者照做会不会失败”。先做这个判断,后面的改写工作量会小很多。
很多旧教程的问题不是名称过时,而是读者不知道旧名称指的就是现在看到的东西。最小成本的补救是在读者最可能困惑的位置补一行对照,例如:
旧称“XX中心” → 现称“XX管理”(以当前界面显示为准)
这行动作要放在三处:文章开头一句总说明、第一次出现旧名称的段落、以及操作步骤中第一次需要点击的位置。放在文末统一说明,读者往往已经卡住并离开。
补完对照后,做一个验证动作:找一位不熟悉这篇教程的同事,让他只按步骤操作,记录他在哪一步停下来。停下来的位置就是需要改写的位置,而不是你主观觉得“应该没问题”的位置。这个验证结果直接决定下一步是继续小修还是重写整段。
出现以下任一情况,保留原文反而会误导读者,应改写对应段落:
改写时只动受影响的部分:保留仍然成立的策略分析,替换失效的操作描述。不要因为一个按钮改名就把整篇教程推倒重写,那会丢掉仍然有效的经验内容。
反过来说,如果旧名称只是措辞变化、入口位置和操作结果都没变,改写就是多余劳动。这种情况下补一行对照即可,把精力留给真正失效的段落。
假设某篇旧教程教读者在微博上完成一次品牌活动的内容发布,文中反复出现一个已经改名的功能入口。第一种处理:只把全文旧名称替换成新名称,不做其他改动。如果入口位置和操作顺序没变,读者能顺利完成,这种处理成立。第二种处理:名称替换后,读者仍在某一步找不到入口,因为该功能已被合并到另一个模块。此时需要改写那一步,并说明新入口下操作顺序的变化。
这个例子说明:全局替换是否够用,取决于改名是否伴随路径和顺序变化。先确认这一点,再决定替换范围,可以避免两种浪费——既不用整篇重写,也不会留下走不通的步骤。
与其每次改名后临时补救,不如在教程里预留可更新的位置:
复查时优先处理被读者反馈卡住的教程,而不是按发布时间平均用力。读者卡住的位置,就是可理解性真正受损的位置。按这个顺序处理,旧教程即使名称过时,也仍能作为参考资料继续使用。