先别按“文章发布时间”批量改。把旧文章里指向被改版产品文档的每一处引用列出来,再按“引用是否还能独立成立”分三档处理:链接文字与目标标题一致、举例仍与新版一致、依赖旧版步骤或参数。只有第三档必须立刻改,前两档可以排期,否则你会把大量仍然有效的旧文误伤。
打开你手头那篇旧文章,逐个找出指向产品文档的位置。常见形式不止超链接:正文里写“详见某某文档”、图片说明里提到某个设置页、代码示例注释里带文档路径、文末“相关阅读”列出旧指南。把它们记成一行一条,字段至少包括:旧文位置、链接文字、目标文档旧标题、目标文档新标题、引用用途(解释概念、给出步骤、提供参数、作为延伸阅读)。
这一步的产出是一张可核对的表。没有这张表,改版后你只能凭印象判断“好像提过”,漏改和误改都会发生。假设某旧文在解释一个概念时引用了文档 A,而文档 A 改版后标题变了但概念定义没变,这类引用属于“链接文字与目标标题一致”档,改文字即可,不必重写段落。
判断一处引用是否需要更新,看三个可核对的证据,而不是看它出现在文章开头还是结尾。
反过来,仅仅因为文档改版了、页面变了,并不自动意味着旧文里每一处引用都要动。把“文档更新”当成“引用失效”是常见的过度反应。
有时你会看到某篇旧文的引用点击下降,于是判断“引用该更新了”。但这个信号有多个合理解释:文档新版可能把入口收进了导航,读者不再从旧文进入;也可能旧文本身在改版同期被调整了位置;还可能只是统计周期与改版时间不完全对齐。引用量下降不能单独证明引用处理正确或错误。
要区分这些解释,做一次小范围核对:随机挑五处引用,手动点开,确认链接文字与目标标题是否一致、示例是否仍可复现。如果五处里三处标题已对不上,问题更可能在引用文字;如果五处标题都对得上但示例已变,问题在示例同步。这个动作的结果决定你下一步是批量改文字,还是优先核对示例。
处理顺序建议从影响读者动作的引用开始:先改承担步骤和参数的引用,再改仅作延伸阅读的引用。每改一处,回到旧文里读一遍上下文,确认改完后句子仍然通顺、指代仍然清楚。假设旧文写“在设置页把模式选为 A”,而新版文档已改为“模式 B”,你需要同时改正文里的模式名和链接文字,只改链接文字读者仍会照旧操作。
改完后记录两件事:这处引用属于哪一档、改动了哪些字段。这份记录能让下一轮文档改版时更快判断哪些旧文会受影响。如果某篇旧文里超过一半的引用都落在必须改的一档,考虑的不是逐处修补,而是重写该段引用结构,把分散引用合并成一次指向新版入口。
当引用只用于说明一个稳定概念、且新版文档仍保留该概念定义时,可以不动,或只在新旧标题差异明显时补一句现名。当旧文本身已不再被维护、也没有内部链接指向它时,更新引用的收益有限,优先处理仍在被访问的旧文。
把这些判断写进你的引用清单备注列,下次改版时直接复用。关键不是把所有旧文改一遍,而是让每一处引用在读者点击的那一刻仍然成立。