先给结论:产品文档改版后,旧文章里的引用要分两类处理。凡是引用“会随版本变化的事实”——功能名称、操作路径、参数、限制条件、截图对应的界面——必须逐条核对并更新或删除;凡是引用“不随版本变化的判断”——问题成因、选型逻辑、通用方法——可以保留,但要检查它是否仍与新版产品定位一致。判断依据不是引用出现在文章哪个位置,而是这条信息在新版文档里还能不能找到对应来源。
这类引用的共同特征是,读者点进去或照着做,能得到一个确定结果。改版后如果结果变了,引用就从资产变成负债。
实施动作可以这样安排:先给旧文里的每条产品事实引用打一个来源标记,格式用 来源:文档章节 + 核对日期。改版发布后,只复查带标记的句子,不重读全文。这个动作的结果是,你能得到一张“待核对引用清单”,它的长度直接决定这轮改稿是半天还是两周,也决定哪些文章值得投入、哪些应该直接下线。
问题成因、取舍逻辑、排查顺序这类内容,通常不随一次文档改版失效。它们的风险不在“过时”,而在“和新版定位打架”。
假设一个场景:旧文用“先保证兼容性,再考虑性能”作为选型建议,而新版文档把默认配置改成了性能优先。这时旧文的结论没有事实错误,但会给读者相反的预期。处理方式是保留论证,改写结论句,让它显式说明适用前提。这个动作的结果是,文章仍然可用,但读者不会拿旧结论去套新默认值。
例外情况有三种,遇到时不必强行保留:一是旧文服务的功能已整体退出,任何改写都是给不存在的东西续命;二是旧文依赖的合作关系已经结束,引用方本身不再存在;三是旧文的论证链条全部建立在被替换的旧机制上,保留标题只会误导搜索进来的读者。这三种情况下,更合适的动作是设置跳转或明确标注停用,而不是修补。
不必先全量盘点。从旧文里挑引用最密集的三到五篇,按上面的两类条件各核对一遍,记录每条引用属于“事实需更新”“判断需改写”“应停用”中的哪一类。如果抽查样本里事实类引用占比高,说明这批文章与产品版本绑定紧密,适合按发布批次成批处理;如果判断类引用占比高,说明改版影响有限,可以只处理结论句。
需要提醒的是,旧文流量下降、抓取减少或某条引用对应的页面消失,都不能单独证明这条引用该删。流量变化可能来自季节、渠道调整或搜索需求本身转移;页面消失可能只是文档站结构调整。把现象当成结论,容易删掉仍然有效的判断类内容。核对来源是否仍存在、结论是否仍成立,才是可复用的依据。
改稿完成后,在文末或内部记录里写一句可复查的说明,例如“原引用新版已移至二级页,操作步骤同步调整;选型建议保留,补充默认配置前提”。这样的记录能让下一次文档改版时快速定位受影响段落,也能让协作的人判断这次改动是否改变了文章结论。
如果一篇文章同时包含事实引用和判断引用,优先改事实部分,再决定判断部分是否需要补充前提。顺序反过来,容易在还没确认事实的情况下先改结论,导致改完仍与新版文档不一致。