我个人认为代码本身就是最好的注释除数据库表设计表和字段的注释。为什么很多人喜欢Java大部分喜欢Java的都喜欢读Javaoracle公司和开源组织的源代码而且大部分Java框架和架构都是开源的。API已经很难满足很多程序员的需求而且读上级开源代码程序员自信容易检查、排查错误能很好的交流解决问题。