コーディング規約にも参考にできるかな

大抵の場合、ドキュメントの充実度は、APIそれ自身の完成度にも大きくかかわってきます → 実際、ドキュメントが貧弱すぎて、(開発当初からコミットしている人以外には)使い方がさっぱりわからないのもあるし。