结论先说:产品文档改版后,旧文章里需要优先更新的不是所有提到产品的句子,而是那些把旧文档当作操作依据的引用——包括功能路径、参数表、截图说明和步骤编号。判断标准可以概括为一句话:读者如果照着旧文章去操作,会不会因为文档改版而走错路。会,就必须改;不会,可以缓。这个结论有一个明确的反例边界,下面会说明。
旧文章里的产品引用大致分两种。一种是操作依据,读者需要照着它完成某件事,比如“在设置页找到XX开关,打开后保存”。另一种是背景提及,只是顺带说明产品能力,比如“该产品支持批量导出”。文档改版通常改变的是界面位置、字段名称、步骤顺序和默认值,这些变化只影响第一类引用。
实际操作上,可以拿改版前后的文档做一次对照,把差异归成三类:
旧文章中凡是出现具体路径、具体字段名、具体步骤编号的地方,都属于需要核对的对象;只出现产品名和一句能力描述的,通常不必动。
上面“只改操作依据”的结论,在一个条件下会失效:旧文章本身承担了文档没有覆盖的场景。假设某篇旧文章写的是一个已经下线的旧版操作流程,而新版文档只讲了新流程,没有说明旧数据如何迁移。这时旧文章虽然“过时”,却仍是唯一提到迁移注意事项的地方。直接按新文档改写,会把这段独有信息删掉。
遇到这种情况,处理顺序要反过来:先判断旧文章里有没有新文档没有的内容,有就先保留并标注适用版本,再补新流程;没有才按常规替换。这个反例说明,不能只以“文档已改版”为唯一依据决定删改。
假设旧文章里有一句:“点击右上角‘导出’,在弹窗中选择 CSV 格式。”改版后文档显示导出入口移到了左侧栏,格式选项改为下拉框。判断过程可以是:
三条都指向“需要更新”,动作就是把这句话替换为新路径和新控件描述。更新后,下一步应检查同一篇文章里是否还有依赖这句话的截图或后续步骤,避免只改文字、留下对不上的图。
单篇判断容易,批量处理时会出现例外。旧文章数量多、改版涉及字段广时,逐篇同步的成本可能超过收益。这时可以按引用密度分流:一篇文章里操作依据引用超过一定数量,且该文仍有稳定访问,就优先改;只有一两处背景提及的,可以合并到下一轮内容维护时处理。
需要提醒的是,访问量下降或某篇文章长期没有更新,不能单独证明它不值得改。也可能是季节性波动、渠道变化或链接失效造成的。要判断是否值得投入,更可靠的做法是看它是否仍在被站内其他页面引用、是否仍是某个操作问题的少数答案之一。
确定要改之后,具体动作是建一份对照表,字段包括:旧文章地址、引用类型(操作依据/背景提及)、改版差异类别、是否含新文档未覆盖内容、处理状态。每处理完一篇,回填状态并记录替换后的表述,方便下一轮改版时直接比对,而不是重新通读全部旧文。
这份表的作用不是一次性清账,而是让“文档改版—旧文更新”变成可复查的流程:下次改版时,先查表里标记为操作依据的条目,再决定是否扩大范围。这样既不会漏掉真正会误导读者的引用,也不会因为追求全部同步而把维护成本推到不可持续。