先给结论:产品文档改版后,旧文章里的引用不是按“有没有提到产品”来更新,而是按引用的类型分流。指向被删章节的链接和步骤描述必须改;仅作为背景提及产品名称、且结论不依赖具体界面的句子可以保留。判断标准只有一条——读者照着这句话操作时,会不会走到一个已经不存在的入口或步骤。
旧文章里的引用大致分两种。第一种是操作性引用:写着“在设置页点击某某按钮”“按文档第几节配置参数”这类句子,读者会照着做。第二种是背景性引用:用产品能力说明一个观点,比如“这类工具通常支持批量导入”,读者不需要打开产品界面。改版后前者几乎都要动,后者多数可以不动。
之所以要这样分,是因为改版影响的是路径和界面,不是概念。如果旧文章只是借产品举例说明一个通用做法,产品入口变了并不影响这句话成立。反过来,只要句子里包含可点击的路径、按钮名称、配置顺序,就必须核对改版后的文档是否还保留同样的结构。
如果改版只是调整了导航层级或改了章节标题,内容本身还在,处理成本最低。动作是:把旧文章里指向旧章节的锚文本和链接,替换成新文档中对应章节的地址,同时保留原来的说明文字。做完这一步后,再抽查三到五篇引用最密集的旧文章,确认跳转后读者能直接看到被引用的那段说明,而不是落在文档首页。
这种情况下的例外是:如果旧文章把旧章节标题当作论据写进了正文,比如“正如文档中‘高级配置’一节所述”,那么改标题后这句话会显得指代不明。此时应改成对内容的概括,而不是继续引用一个已经改名的标题,否则下次改版还要再改一遍。
如果改版把多个章节合并,或删掉了某个配置项,链接替换已经不够。这时要回到旧文章的句子层面,判断它想传达什么。若原句是在教读者完成一个操作,而该操作在新文档中换了位置或换了名称,就按新文档重写这一步;若该操作在新版本中已不存在,就要在旧文章里明确说明这一变化,而不是留一个死链或指向无关章节。
一个假设的例子:某旧文章写“先在账户设置里开启同步,再到数据页确认”。改版后同步开关移到了项目级设置,数据页改名。此时正确做法是把这两步按新文档重写,并在句末补一句说明入口位置已调整。这样读者不会因为找不到旧入口而认为文章失效。这个动作的结果是:旧文章从“过期教程”变成“仍可用的迁移说明”,下一步只需在文档再次变动时重复同样的核对。
与其把旧文章全部读一遍,不如先建一份引用清单。做法是:在站内搜索旧文档的章节标题、按钮名称和旧链接路径,把命中的文章列出来,标注每处引用属于操作性还是背景性。这份清单可以直接决定工作量——操作性引用逐条核对,背景性引用只在产品定位变化时才看。
需要提醒的是,站内搜索命中数量下降,不能单独证明引用已经处理干净。命中变少也可能只是因为旧文章被其他改动覆盖、搜索索引尚未更新,或者标题写法变了导致匹配不上。所以清单核对之后,仍要人工抽查若干篇,确认句子层面确实不再指向旧结构。
把这三类排除后,真正需要改的引用通常集中在教程、配置说明和排错步骤里。先处理这些,再决定是否顺带优化其他句子,比全站重写更可控。