一起学习
Java 语言按照 Javadoc 注释约定采用了一种集成的方法来进行 API 文档编制。Javadoc 工具可以帮助生成好的 API 文档，然而大多数 Java API 文档却很糟糕。因为它是源代码的一部分，所以 API 的文档编制职责最终还是落到了工程师身上。在本文中，Brian 对 Java 文档编制实践的当前状态进行了严厉的批评，同时提供了一些关于如何编写更有用的 Javadoc 的准则。
详细文章请浏览
http://www-900.ibm.com/developerWorks/cn/java/j-jtp0821/index.shtml
下载本文示例代码
Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？Java 理论和实践：我必须对那些内容进行文档编制吗？
