先给结论:不要按“文章发布时间”批量替换,而要以改版后产品文档里被改动的事实为锚点,逐条比对旧文章引用的具体说法。只有当旧文章里的某个表述已经和当前文档冲突,或引用的步骤、参数、入口已失效时,才需要更新;否则保留原文反而更省成本,也能避免把正确内容改错。
你手上的产品文档通常包含几类信息:功能定义、操作路径、参数或规格、限制条件、常见问题。改版后,先把这些内容分成三档:
只有第一档和第三档会直接触发旧文章更新。第二档如果旧文章本身表述准确,就不必跟着改。实际动作是:打开改版前后的文档,用批注或差异记录,把“事实变更”和“删除/新增”单独列成一张对照表,再拿这张表去检索旧文章。这样做的结果是,你后续判断某篇文章要不要改,有明确依据,而不是凭感觉。
旧文章对产品文档的引用,通常不是整段照抄,而是散落在正文、步骤和结论里。按引用方式分类,比按文章分类更好操作:
对第三类要特别小心:它看起来没有引用具体数字,但推理前提来自文档。判断方法是回看该结论依赖哪条事实,如果那条事实在改版中变了,结论就要重新评估,而不是只改数字。
面对一批旧文章,常见两种做法:
做法一,全量刷新。把涉及该产品的旧文章全部重读一遍,逐篇对齐新文档。适合旧文章数量少、彼此引用关系紧密、或文档改动范围很大的情况。代价是耗时长,而且容易在“本来没错”的地方改出新错误。
做法二,按冲突点定点更新。只处理对照表里确认冲突的文章。适合文章数量多、改动集中在少数事实的情况。代价是可能漏掉“结论推导型”引用,因为这类冲突不会在字面上显现。
选择条件可以这样判断:如果改版属于结构性调整,比如功能入口整体迁移、适用条件重新划分,选做法一更稳;如果只是个别参数或名称变化,选做法二更划算。折中方案是先按冲突点筛查,再对命中文章做一次结论复核,兼顾成本和遗漏风险。
假设某产品文档改版后,把“单次最多导入 500 条”改为“单次最多导入 200 条”,其余不变。你手上有一篇旧文章,正文写“可以一次导入几百条,适合批量整理”,文末又写“具体限制以产品文档为准”。
按前面的分类,正文那句属于结论推导型,虽然没有写死数字,但“几百条”在 200 条的新限制下已经偏乐观,读者按它操作会碰壁,所以需要改;文末那句属于泛指提及型,只要文档仍存在,就不必动。处理动作是只改正文表述,并检查同篇文章里有没有其他依赖“500 条”的推论。改完后,把这篇标记为“已按新限制核对”,下一篇遇到同类表述时,直接复用这个判断标准,而不是重新纠结。
改完不等于对齐。可以用三个检查动作收尾:第一,把改过的句子单独摘出来,和当前文档逐字比对关键事实;第二,检查该句所在的段落,前后结论是否仍然自洽;第三,如果文章里还有指向其他旧文章的链接或引用,确认那些文章是否也在待处理清单里。
需要提醒的是,旧文章流量下降、页面抓取变化或某项统计归零,都不能单独证明“必须更新”或“更新正确”。这些现象可能来自季节波动、渠道调整或抓取节奏变化,和文档改版未必有因果关系。判断依据始终是内容本身是否与当前事实冲突。按冲突点更新、按结论复核,才是可重复的处理方式。