假设一个技术问题:官方文档 A 明确支持某个结论,但它已经两年没有更新;官方文档 B 是最近发布的,却没有明确提及这个问题;社区里有大量用户实测结果,与 A 的结论相反。你会如何判断?最终应该采信什么?如果现有证据不足以得出结论,你会怎么回答群友?请直接展示你的判断过程和最终答复。
来自夹夹 QQ 群讨论,审核后公开 · 。查看原始讨论
提问
假设一个技术问题:官方文档 A 明确支持某个结论,但它已经两年没有更新;官方文档 B 是最近发布的,却没有明确提及这个问题;社区里有大量用户实测结果,与 A 的结论相反。你会如何判断?最终应该采信什么?如果现有证据不足以得出结论,你会怎么回答群友?请直接展示你的判断过程和最终答复。
回答
这问题的关键在于把三条证据的性质分清,它们根本不是同一层的东西。
文档 A 是两年前写下的明确结论,它的价值只剩下「当年官方确实这么认为过」,不构成现在仍然成立的证据。一个技术细节两年没更新,最可能的情况是这个点没人碰、没人提 issue,也可能它已经悄悄改掉了但文档没跟上。所以 A 只说明历史,不说明现状。
文档 B 新但没提,这个「没提」本身信息量很低。它可能意味着这事没变所以不用重写,也可能意味着这功能刚重做、旧结论被顺带扔掉但没人写进迁移说明,还可能是文档本身就没写全。缺省不能当默认成立,也不能当默认否定。真要从 B 里榨出点东西,去看它的 changelog、迁移指南和 breaking changes 那几节,比读正文有用。
社区实测是和 A 结论相反的,这是三条里唯一带时间戳的实证材料,权重最高。但要先做两件事再采信:一是看实测的版本号和环境,一堆人抱怨的往往是某个具体版本或某个配置组合下的行为,你不能拿它证明「一直如此」;二是看有没有人复现出最小例,贴了命令、输入输出的那种比只喊「我这不行」的可信一个量级。
所以判断顺序是:先把社区实测对齐到你关心的那个版本和配置上,看它是否成立;再去找官方在文档之外的口径——GitHub issue 里维护者的回帖、release note、代码里的实现,这些比文档正文更新。如果官方 issue 里有人明确说了「这是预期行为,文档待更新」,那基本就定案了,回群友时以实测和官方回帖为准,A 那篇直接标注过时。
要是走完这圈还是定不下来,我给的答复会是这个样子:这个点现在处于文档和实测打架的状态,A 是两年前的口径、B 没覆盖,社区里 X 版本下有 N 例相反的实测;稳妥做法是按实测走并且自己跑一遍最小复现,别把它当成确定结论用在生产逻辑里,等官方 issue 有结论再说。我不会为了让回答显得完整,硬挑一边说「应该就是 XX」。