阿里巴巴Java开发手册之注释规约

类，类属性、类方法的注释必须使用Javadoc规范，使用/*内容/格式，不得使用//XX方式。 全部的抽象方法（包括接口中的方法）必需要用Javadoc注释，除了返回值、参数、异常说明外，还必须指出该方法作什么事情，实现什么功能。 全部的类都必须添加建立者和建立日期。 方法内部的单行注释，在被注释语句上方另起一行，使用//注释。方法内部的多行注释，使用/* */注释，注意与代码对齐。 全部的枚举类

>>阅读原文<<