16.6 更高层的注释更容易维护
关于维护文档的最后一个想法:如果注释比代码更高层、更抽象,则更容易维护。这些注释并不反映代码的细节,所以它们不会受到微小的代码变化的影响;只有整体行为的变化才会影响这些注释。当然,正如第13章所讨论的,有些注释确实需要详细和精确。但一般来说,那些最有用的注释(它们不会简单地重复代码)也是最容易维护的。
Last updated
关于维护文档的最后一个想法:如果注释比代码更高层、更抽象,则更容易维护。这些注释并不反映代码的细节,所以它们不会受到微小的代码变化的影响;只有整体行为的变化才会影响这些注释。当然,正如第13章所讨论的,有些注释确实需要详细和精确。但一般来说,那些最有用的注释(它们不会简单地重复代码)也是最容易维护的。
Last updated