本节书摘来华章计算机《数据结构与抽象：Java语言描述（原书第4版）》一书中的第1章 ，第1节，［美］弗兰克M.卡拉诺（Frank M. Carrano） 蒂莫西M.亨利（Timothy M. Henry） 著 罗得岛大学 新英格兰理工学院 辛运帏 饶一梅 译 更多章节内容可以访问云栖社区“华章计算机”公众号查看。
P.2 说明方法
将类的目标及方法与其实现分开，对一个成功的软件项目来说是至关重要的。应该说明每个类及方法，而不关心它的实现。写这些描述能捕捉到你最初的想法，并开发它们，从而才能足够明确地实现它们。你写的描述应该作为注释放到程序中有用的地方。你不能在写了程序之后为了应付老板才写注释。
