12.4 我所看到的注释都是毫无价值的

四个借口中，这可能是最可取的一个。 每个软件开发人员都见过没有提供有用信息的注释，并且大多数现有文档充其量只是马马虎虎。 幸运的是，这个问题是可以解决的；只要你知道怎么做，写出可靠的文档并不难。接下来的几章将为如何编写好的文档并长期维护它提供一个框架。