我们的文档里有个bug。不是错别字——是严格意义上的bug：一个错误的值，顺着它下游的所有内容一路传播。

我在一个巴西卡牌游戏平台工作，这个平台自2010年上线，注册玩家超过300万。我们运营Buraco、Canastra、Tranca、Truco、Sueca和Dominó六款游戏。在这样的平台上，规则页面不是营销素材，而是用散文写成的产品参考实现。玩家会在游戏中途翻出来解决争执。

打开网易新闻 查看精彩图片

八月，我们发现一个规则页面上的某一段落已经错了很久。因为那个页面是其他所有内容的核对基准，大约四十篇其他内容都继承了同一句错误的话：博客文章、FAQ条目、FAQPage JSON-LD、一个已发布的视频、社交媒体文案、一篇帮助中心文章。

每一篇都经过审核。所有审核都通过了。

这才是值得写下来的部分。

错误的说法是关于Truco规则中藏牌的一条说明。文档说第一轮不允许藏牌。实际游戏行为不同：开局的那个玩家不能藏牌；从第二个玩家开始，任何一轮都可以藏——包括第一轮。

客户端把正确答案写得明明白白。有一个hideCard标志，只要一轮中任何一张牌落到桌上就翻转为true，每轮结束重置。游戏甚至会在自己的错误提示里打印出正确规则。

所以真相就在运行中的产品里。但没人拿运行中的产品当参照。所有人都在拿文档当基准——包括写新文档的人。

我们的审核步骤在每个检查清单里都写着类似这样的版本：

✅ 已对照官方规则验证

这个步骤确实做了它承诺的事：把新内容和真相来源比对，确认一致。内容确实忠实。但来源是错的。对着一个错误的基准做验证，等于把错误盖章确认为“已验证”。