阿里巴巴Java開發手冊之註釋規約

類，類屬性、類方法的註釋必須使用Javadoc規範，使用/*內容/格式，不得使用//XX方式。 全部的抽象方法（包括接口中的方法）必需要用Javadoc註釋，除了返回值、參數、異常說明外，還必須指出該方法作什麼事情，實現什麼功能。 全部的類都必須添加建立者和建立日期。 方法內部的單行註釋，在被註釋語句上方另起一行，使用//註釋。方法內部的多行註釋，使用/* */註釋，注意與代碼對齊。 全部的枚舉類

>>阅读原文<<