公式の和訳(意訳)です.
- IDEでスタイルを設定する, ソースコード構成
- 命名規約
- フォーマット 前半
- フォーマット 後半
- ドキュメントコメント,冗長な記述を避ける
- 慣用表現の使用
- ライブラリのコード規約(この記事)
ライブラリのコード規約
ライブラリを書くときは,APIを安定させるために,追加で以下の規約に従うことを推奨する.
- メンバの可視性を明示する(不用意に public API として宣言することを避ける)
- 関数の返り値やプロパティの型を明示する(実装を変更するときに,不用意に型も変えてしまうことを避ける)
- すべての public なメンバに KDoc コメントをつける.ただし,新しいドキュメントが不要なオーバーライドを除く(ライブラリのドキュメント生成をサポートする)