先给结论:不要为了追上新名称,把旧教程里的功能名全部替换一遍。更稳妥的做法是保留原文动作描述,在首次出现旧名称的位置补一条“名称映射”,并让读者无论按旧名还是新名都能找到入口。如果只改名字、不改步骤描述,读者仍然会在“找不到这个按钮”上卡住;如果只保留旧名,新读者又会误以为教程过期。下面以你手里那篇具体教程或资料页为对象,说明怎么改。
平台功能改名,通常只影响三处:入口名称、入口位置、功能被拆分或合并。处理前先把旧教程从头到尾读一遍,在每个功能名旁边标出它属于哪一层。区分方法很简单:如果只是词变了、位置和结果没变,属于纯改名;如果位置也变了,属于入口迁移;如果原来一个功能现在拆成两个,属于结构变化。三种情况的改法不同,混在一起改会越改越乱。
一个可用的证据是:按旧教程逐步操作,观察在哪一步出现“找不到”或“点进去结果不一样”。如果读者在第一步就找不到入口,问题在名称和位置;如果能找到入口但结果变了,问题在功能结构。这个观察结果决定你后面是补映射、补路径,还是重写步骤。
对纯改名的情况,最省力也最不容易出错的做法是:正文里的动作描述维持原样,只在旧名称第一次出现时加一句括注。例如把“点击‘内容推广’”改成“点击‘内容推广’(该入口现已更名为‘内容加热’,位置不变)”。这样做的结果是:老读者凭旧记忆仍能对上,新读者看到新名也知道该找什么。
名称映射要写清三件事:旧名、新名、位置是否变化。缺少位置说明,读者仍会在页面里来回找。映射只写一次即可,不必每个旧名都重复括注,否则正文会被解释性文字淹没。做完这一步后,回到前面标记的“找不到”位置复测一次,确认读者能顺着新名走通。
如果改名同时伴随入口迁移,仅在名称旁加括注不够。读者知道新名字,却不知道从哪进。这时要把旧教程里的“点击某按钮”替换成一条可复述的路径,例如“进入账号后台,在左侧导航找到‘推广’分组,再进入‘内容加热’”。路径描述要按读者实际能看到的层级写,不要只写一个最终名称。
写完路径后做一次复测:让一个没读过旧教程的人按新路径操作,记录他在哪一层停顿。停顿点就是路径描述还不够具体的地方。这个动作会直接影响下一步——如果停顿发生在导航分组,就补分组名;如果停顿在页面内的按钮,就补按钮前后的上下文。
最麻烦的情况是原功能被拆成两个或多个入口,旧教程的一步操作现在需要分两步完成。这时逐词替换会得到一篇逻辑断裂的教程,因为原来的因果关系已经变了。处理办法是:保留旧教程的操作目标,重排步骤顺序,用一句话说明“原来一步完成,现在分为两步”。
假设旧教程写的是“在推广面板设置预算并提交”,而新版本把预算设置和提交拆到了两个页面。那么改法不是把“推广面板”换成新名字,而是写成“先在预算页设置金额,保存后回到任务页提交”。这里的关键是让读者知道两步之间的依赖关系,否则他会在第一步保存后以为已经完成。重排后同样要复测一次,确认每一步的完成状态都能被读者识别。
改完不等于可理解。用两个视角复测:一个是读过旧版的老读者,看名称映射能否帮他迁移记忆;一个是没读过旧版的新读者,看路径和步骤能否独立走通。两个视角都走通,说明旧教程的可理解性保住了。
如果只能保一个,优先保新读者的走通路径,因为教程的价值在于让当前操作成功,而不是保存历史名称。旧名映射可以精简到一句话,但步骤路径必须完整。这个取舍会决定你后续维护成本:映射越多,每次改名都要跟着更新,所以只保留必要的旧名对照即可。