旧教程不必全部重写,更稳妥的做法是保留原操作路径,在改名发生的那一步加“旧名—新名—判断依据”的对照,并让读者先确认自己看到的菜单属于哪个入口。这样即使平台把“促销活动”改成“营销工具”或把“受众”改成“人群”,读者仍能判断下一步该点哪里,而不是在教程和界面之间反复试错。
很多教程失效,不是因为步骤错了,而是因为作者把当时的菜单名当成了功能本身。平台改名的常见原因是入口重组、功能合并或翻译调整,原来的名称可能只是当时界面上的一个标签。读者按旧教程找不到入口时,真正缺的不是新名称,而是这个名称背后对应的动作:是在设置投放条件,是在查看数据,还是在修改商品信息。
因此保留可理解性的第一步,是把旧教程中的名称还原成动作。例如旧教程写“进入受众设置”,可以改成“找到用于限定投放对象的设置项,旧界面叫受众,新界面可能叫人群或定向”。这样改名后,读者仍能根据动作找到对应位置,而不是死记一个词。
旧教程突然对不上,通常有两种解释,处理方式完全不同。
区分这两种解释,不能只看名称是否变了,而要看读者按旧路径操作时卡在哪一步。如果只是找不到词,但按动作描述仍能完成任务,偏向解释一;如果按动作描述也找不到对应设置,或者原来一个入口现在分成两个,偏向解释二。
要决定旧教程的改动幅度,可以依次核对以下证据。它们不需要平台内部信息,只需要读者或维护者亲自走一遍路径。
这三个证据中,第一个最关键。假设一个旧教程写“在广告设置里选择受众”,现在界面改叫“人群”。如果读者按“选择投放对象”这个动作仍能找到同一设置,那么只需在“受众”后加括号注明“现可能显示为人群”;如果读者发现投放对象设置被移到了商品层级,那么旧教程的步骤顺序就需要重构,而不是简单替换词语。
全文替换看似干净,却会带来两个问题:老读者按旧名称搜索时找不到教程,新读者看到新名称也不知道它和旧教程的关系。更实用的做法是保留旧名作为检索线索,同时把新名和判断依据放在一起。
可以在教程开头加一个简短的对照区,格式如下:
这层对照的作用不是解释平台为什么改名,而是让读者在名称不一致时仍能继续操作。对照区应放在教程最前面,并且只列旧教程中实际出现过的名称,不必追求覆盖平台所有改名。
假设某旧教程的第三步是“点击受众,设置年龄和地区”。现在界面中只有“人群”,且“人群”下面先要求选择“保存的人群”或“新建人群”。这时不能只写“受众已改名为人群”,因为步骤顺序已经多了一层。
更清楚的处理是保留旧教程的第三步标题,但在正文中写成:“旧教程的‘受众’对应现在的‘人群’。如果界面要求先选择已有的人群,再编辑年龄和地区,说明入口多了一层;此时应先确认是否已有可用的人群,再决定是新建还是编辑。若没有可用人群,旧教程的后续步骤需要顺延。”这样读者不会因为多出一层选择而以为教程失效,维护者也能根据“是否多出一层”判断要不要重写后续步骤。
这个例子中的数字和名称只是假设,用来展示判断方法:先看动作是否还能完成,再看步骤顺序是否变化,最后决定是补注还是重构。
最实际的动作,是找一条旧教程,按上面三个证据走一遍,记录卡住的位置。如果只卡在名称,补一行对照即可;如果卡在入口层级或步骤顺序,就只重写受影响的段落,不必把整篇教程推倒。做完这一步后,下一步的维护重点也会更清楚:哪些旧名称值得保留作为检索词,哪些段落需要按新路径改写。这样旧教程不会因为一次改名就失去可理解性,读者也能在界面变化后继续完成操作。