如果您的库没有任何文档,那么它就不会有任何错误。
文档指定了你的代码应该做什么。你的测试指定了它实际上做了什么。
当你的测试强制执行实现与文档中描述的行为不符时,就会出现错误。没有文档,错误就只是未定义的行为。
如果您希望遵循语义版本控制,则在发布向后不兼容的更改时,您的主版本号会发生变化。如果您的代码没有完整的文档,则此类更改不可能存在!
受到多年前与汤姆·因萨姆 (Tom Insam)的一次半记得的谈话的启发。
原文: https://simonwillison.net/2025/May/22/no-docs-no-bugs/#atom-everything