结论先行:旧教程是否还值得保留,取决于改名影响的是“入口名称”还是“操作逻辑”。如果只是按钮或菜单换了叫法,而操作路径、数据口径和判定条件没变,旧教程可以保留,但必须在开头补一段新旧名称对照;如果改名同时伴随入口合并、字段增减或统计口径变化,旧教程就不应原样保留,而要拆成“历史版本说明”和“现行操作版”两部分。下面给出可执行的判断依据和改写动作。
拿到一份旧教程时,不要先改标题里的词,而要先找出它依赖的三类信息:入口位置、可操作字段、结果口径。把这三类分别与当前后台核对,会出现两种成立条件。
判断动作:让一位不熟悉该教程的同事只按旧教程操作一遍,记录他在哪一步停下。停留点若集中在“找不到入口”,属于名称问题;若集中在“填完不知道下一步看哪个数”,属于逻辑问题。这个动作的结果直接决定你是加对照表还是重写正文。
有一种情况容易误判:后台入口名称没变,但同一功能的数据统计范围变了。比如旧教程教读者看某个汇总数字判断效果,而该数字现在只统计部分来源。表面看教程每个字都还对,实际结论已经不可用。
反例的识别信号是:旧教程里出现“只要这个数涨了就说明……”这类把单一指标当结论的句子。只要平台调整了该指标的统计范围,这类句子就会误导。此时即使名称完全没变,也不能保留原判断句,必须改成“该数字反映什么、不反映什么”的描述,并注明适用条件。
确定要改写后,按下面顺序处理,避免只做表面替换。
完成上述动作后,再让同一位同事按新版操作一遍。若停留点消失,说明改写有效;若仍有停留,问题多半出在字段说明而非名称,需要继续细化。
假设某教程原文写“进入某推广页,看某汇总值判断投放是否正常”。改名后,入口名称变了,汇总值也改为只统计部分计划。此时有两种处理:
两种处理的分界不是改名幅度大小,而是读者读完是要“找到地方”还是“做出判断”。前者可轻改,后者必须重写。
先挑出旧教程里所有带结论的句子,逐条标注它依赖的指标和口径。若这些指标未随改名调整,旧教程可保留并补名称对照;若有任何一条口径变了,就先把该条改成带条件的描述,再决定整篇是否重写。这个顺序能让你用最小改动保住可理解性,同时不把已经失效的判断留给读者。