旧教程不必逐句重写,但必须建立“旧叫法—当前入口—判断依据”的对应层。做法是:先确认改名影响的是入口名称、页面结构还是数据口径,再决定加注、改写还是整段替换。只改标题里的词,读者仍会在操作步骤中迷路;只保留旧词,新读者又无法把教程和当前后台对应起来。
功能改名后教程失效,通常不是同一个问题。第一种是入口改名,路径本身没变,只是菜单或按钮换了称呼;第二种是页面重组,旧入口被并入别的模块,原来的点击顺序不再成立;第三种是数据口径变化,名称相似但统计范围已经不同。三种情况的证据来源也不同:入口改名看当前页面上的可见文字,页面重组看操作路径是否还能走通,数据口径变化则要看指标说明和导出字段是否一致。
如果只凭“搜索结果变少”就判断教程过时,容易误判。请求量下降还可能来自季节性波动、内容被其他页面替代、抓取预算重新分配,或者读者改用了站内其他入口。反过来,旧教程仍有点击也不能证明它没有过期,因为读者可能只是点进来确认旧入口是否还在。把“流量变化”和“功能是否改名”分开核对,才能避免把相关现象当成因果。
条件一:旧名称仍被大量读者使用,且新入口与旧入口的操作结果一致。此时优先保留旧教程主体,在首次出现旧名称的位置加一行对照说明,写清“现在页面中显示为某某名称,位置在某某模块下”,并保留原有步骤。这样做的结果是老读者能顺着旧词找到新入口,新读者也不会因为名称陌生而跳出。下一步只需观察读者是否仍在评论或咨询中追问旧入口,若追问减少,说明对照层已经起作用。
条件二:旧入口已经无法完成原有操作,或新页面要求先完成额外设置。此时不能只加注,应把相关段落替换为当前路径,并在段首说明“旧版本中的某操作已不再单独出现,现在需要先完成某设置”。替换后要回头检查教程中的截图描述、步骤编号和结果判断是否同步更新,否则前面改了名称、后面仍按旧流程验收,读者会在最后一步失败。这个动作的影响是:教程从“名称对照”升级为“流程重建”,后续更新应以新流程为基线,不再维护两套步骤。
出现与直觉相反的结果时,先收集三类可核对证据,再决定改教程还是改内容。第一类,当前页面文字:打开对应模块,记录实际显示的名称和相邻菜单,确认旧词是否还出现在帮助说明或搜索提示中。第二类,操作结果:按旧教程走一遍,记录在哪一步无法继续,是找不到按钮,还是找到后结果与旧描述不同。第三类,数据字段:对比导出报表中的列名和指标说明,确认是名称变化还是统计范围变化。三类证据指向不同结论:只有第一类变化,加注即可;第二类中断,必须替换步骤;第三类变化,则要在教程中增加口径说明,避免读者拿新旧数据直接比较。
假设一个场景:旧教程写“在某某中心查看某指标”,当前页面已改为“在某某模块查看另一名称的指标”。如果导出字段和计算方式没变,那么这是入口改名,加注对照即可;如果字段从“按天汇总”变成“按小时汇总”,即使名称相近,也属于口径变化,教程必须补一句“旧数据与新数据的时间粒度不同,不能直接相加”。这个例子只用于说明判断方法,不代表任何平台现行界面。
具体动作可以按下面顺序执行:
<span>或普通括号加注当前名称,不改变原有步骤编号。执行后要检查两个结果:新读者能否在不看旧名称的情况下完成操作;老读者能否根据对照说明找到新入口。若两者都成立,旧教程就保留了可理解性,不需要整篇推倒重写。例外是:如果平台已经明确停止旧功能,或旧教程涉及的具体服务已无法访问,那么加注会产生误导,应改为归档说明,并引导读者查看当前可用流程。
改名影响的是名称和路径,不是所有判断标准。商品标题的写法、属性填写的完整度、主图与详情页的信息一致性,这些原则通常不随某个入口改名而失效。把它们一起改掉,反而会让教程失去可复用部分。需要同步检查的是那些依赖具体页面位置的说法,例如“在左侧菜单第三项”“点击右上角按钮”。这类描述一旦页面重组就会过期,应改为按模块名称和操作结果来描述,而不是按坐标描述。
最后,不要把站内搜索、推荐分发和广告投放混在同一套改名处理里。站内搜索入口改名,影响的是关键词和商品信息的匹配路径;推荐分发改名,影响的是内容被展示的场景;广告后台改名,影响的是投放设置和报表字段。三者证据不同,教程的加注位置也不同。先确认旧教程服务的是哪一类操作,再决定改哪一层,才能让旧内容在新名称下继续被读懂。