把答案从“依赖外部链接才能读懂”改成“脱离外部资料仍能读懂”,关键动作是区分两类内容:一类是外部资料本身承载的结论,另一类是引用只用来补充出处和延伸阅读。前者必须把结论、条件、边界和例子写回正文;后者可以保留链接,但要接受它失效后不影响理解。判断依据不是链接多少,而是删掉所有外部引用后,读者能否独立判断该做什么、不该做什么。
外部资料失效后,真正受损的是那些“结论在别处、正文只剩指路”的段落。常见信号有三种:正文只写“详见某处”“参考某资料”,却没有复述关键条件;结论依赖外部页面里的数字、时间或适用范围;步骤中某一步必须点开外部页面才知道下一步做什么。出现任一信号,就应把该结论改写为自足段落。
反过来,如果外部资料只是出处证明、延伸阅读或背景补充,删掉后正文仍能回答“是什么、适用于谁、怎么做、例外是什么”,就可以保留引用,同时接受它可能失效。此时不必强行把整份外部资料搬进正文,否则会增加维护负担,也会让页面偏离原本主题。
当外部资料失效,但它支持的结论仍然有效,选择是“保留结论、重写依据”。实施动作分三步:第一,用一句话写出结论;第二,补上结论成立的前提,例如适用对象、时间范围或限制条件;第三,给一个可独立理解的短例子。这样做的结果是读者不再需要外部页面,下一步可以只检查例子是否与当前内容一致,而不必重新寻找原始出处。
假设某段旧内容写“按外部资料,某类设置应保持默认值”,链接失效后,可以改写为:“在未明确需要自定义的情况下,保持默认值可减少后续调整;如果业务规则要求覆盖默认值,则应记录覆盖原因。”这个例子只说明改写方法,不代表任何真实项目结果。改写后,读者能独立判断默认值与自定义之间的取舍。
如果结论必须依赖外部资料中的具体数据、界面或流程,而资料已经失效,不能凭记忆补写。此时选择是“先降级,再决定保留还是移除”。降级动作包括:把确定性表述改为条件表述;删去无法核实的具体数字;把操作步骤改成判断原则。完成后再问一次:这段内容是否仍能帮助读者做决定。如果不能,就移除,而不是用模糊措辞维持篇幅。
需要说明的是,外部资料访问失败、页面返回错误或抓取不到,并不单独证明该结论已经失效。它还可能是临时故障、访问权限变化、地址迁移或抓取方式不适用。因此,先确认结论是否仍成立,再决定改写或移除,比直接删除更稳妥。
具体做法是暂时隐藏或忽略所有外部引用,只读正文。逐段回答三个问题:这段在回答什么;读者能否不点任何链接就理解;如果只能记住一句话,是哪一句。若第三问的答案不在正文里,就把那句话补进段落开头。补完后,再恢复引用,仅把引用当作出处或延伸阅读。
这个动作的结果会直接影响下一步:能独立阅读的段落保留并减少后续维护;不能独立阅读的段落进入改写或移除清单。对于旧系统或旧合作关系退出场景,还可以把仍然有价值的判断原则、适用条件和例外单独整理,避免整段内容随外部资料一起消失。
有两种情况不必强行保留。第一,内容只服务于已经退出的合作关系或旧系统,且没有可迁移的判断原则;第二,外部资料是唯一事实来源,而正文没有能力在不编造的前提下重写。此时移除比留下半截答案更清楚。另一种边界是:如果外部资料仍然可访问,只是你无法确认其长期存续,可以保留引用,同时在正文写出最小必要结论,不必等待资料失效后再处理。
最终判断标准可以固定为一句:读者在没有任何外部资料的情况下,能否知道该内容适用于什么条件、采取什么动作、遇到什么例外时停止。能,就保留;不能,就改写或移除。