旧文章里的引用是否要动,不取决于文章发布时间,而取决于它引用的那个对象在改版后是否改变了含义、位置或存在状态。先把你手头这篇文章里所有指向产品文档的链接、功能名、参数和截图列出来,再对照改版后的文档逐条判断,而不是整篇重写。
打开你要处理的旧文章,把以下四类引用逐条摘出来,写成一份清单:
清单里每条都记下它在文中的位置和上下文用途。这一步的作用是让你后面能按条判断,而不是靠印象决定“要不要改”。如果清单超过二十条,先按出现顺序编号,方便后续核对时定位。
拿改版后的产品文档,对清单逐条比对,分成三类处理。分类依据是引用对象在改版后是否仍指向同一含义:
关键是第三类。很多旧文章出问题,不是因为链接失效,而是链接还能打开,但页面内容已经变成另一个东西,读者按文中描述去操作会得到不同结果。判断方法是:只看改版后的文档,能否复现文章里描述的那一步操作。不能复现,就归入第三类。
假设旧文章里有一句“该设置默认关闭,需要手动开启”,而改版后文档写的是默认开启。链接本身没变,页面也能打开,但这句话已经和文档矛盾。
处理动作是:先确认改版后的默认值是否对所有账号类型一致。如果一致,直接改这句话;如果不一致,就要在文中补上适用条件,而不是简单把“关闭”换成“开启”。改完之后,回到文章里其他引用同一参数的句子,检查是否也需要同步,因为一处参数变化往往牵连多段描述。这一步的结果决定了你是只改一句,还是要把整节操作说明重新核对一遍。
不要按文章从头到尾顺序改,按风险从高到低处理更省力:
每改完一条,在清单上标记状态。全部标记完成后,再通读一遍文章,确认改动后上下文仍然连贯。如果发现某段被改得只剩链接替换、论述已经和文档脱节,说明它属于第三类,需要补写而不是继续微调。
第一,检查文章内部是否还有指向同一文档的其他链接,避免只改了一处、漏掉另一处。第二,如果这篇文章被其他旧文章引用,把被引用的改动同步到那些文章,否则问题只是从一个页面转移到另一个页面。这两步做完,再决定是否需要更新文章的更新时间或摘要,而不是在改引用之前就先动这些表面信息。