旧教程的可理解性不取决于功能有没有改名,而取决于它是否把“操作路径”和“结算含义”分开写。改名冲击的只是路径描述,佣金比例、结算口径、生效条件这些含义层内容通常不变。把两者混在一句话里的旧教程最容易失效,分开写的旧教程只需要加一条对照说明就能继续用。
常见的情况是:后台某个入口换了名字,旧教程里写的路径点不到了,可教程里给出的佣金比例、结算周期、结算对象却和现在完全一致。于是出现两种判断分歧——有人主张整篇下架重写,有人主张原样保留。两种做法都可能出错,因为“路径失效”和“含义失效”是两件事,混在一起判断就会误伤。
第一种解释是纯改名:功能本身没动,只是入口名称、所在分组或页面标题变了,佣金比例的计算方式、结算对象、生效时间都没变。这种情况下旧教程的结论部分仍然成立,只有操作步骤需要补注。
第二种解释是改名伴随语义调整:新名字对应的范围可能扩大或收窄。比如原来叫“推广计划佣金”,改名后叫“渠道佣金”,如果新名字把更多渠道纳入同一套结算规则,那么旧教程里“这个比例只影响某类推广位”的结论就不再成立。这时候保留旧教程会误导读者。
能区分这两种解释的证据不在入口叫什么,而在结算结果是否一致。可以按下面的顺序核对:
只有第一项一致、后三项也一致时,才能判定为纯改名。任何一项出现差异,都应把旧教程归入“需要重写结论”的一类。
判定为纯改名后,实际动作是在旧教程里加一层对照说明,而不是重写全文。具体做法:在涉及入口路径的段落旁,用一句话标注“该入口现名为某某,路径变为某某,佣金比例与结算规则未变”。这样读者看到旧路径时能自行映射到新入口,结论部分不需要改动。
这个动作的结果会直接影响下一步:如果加注后读者仍频繁反馈“找不到”,说明改名同时调整了页面层级,路径描述需要整体重写;如果加注后反馈消失,说明旧教程可以继续沿用,只需在文首加一条更新说明。判断依据是读者的实际卡点位置,而不是改名本身。
假设某旧教程写“在推广计划页把佣金设为5%,次日生效”。后台改名后入口变成“渠道管理”,比例仍为5%,但生效时间改为实时。此时加注路径不够,因为生效条件变了——旧教程里“次日生效”的结论会误导设置时机。正确做法是保留比例结论,改写生效条件那一句,并说明改动原因。如果只加路径对照而不改生效条件,读者按旧教程操作后会以为设置没生效而重复提交。
当改名同时满足以下任一条件时,加对照层的成本高于重写:结算对象范围变化、生效条件变化、新旧入口并行且规则不同、旧教程中超过一半的步骤描述涉及已失效路径。这些条件下,旧教程的可理解性无法靠局部加注恢复,因为读者需要的是新的操作顺序,而不是旧顺序的翻译。
反过来,如果只是入口名称变化、结算含义完全一致、旧教程的结论部分占全文多数,那么保留加注是更省成本的选择。判断的关键始终是结算结果是否一致,而不是名称是否相同。