** コメント
> メソッド定義の中にはコメントは記述しない。(コメントが必要だと思わ
> れるようなコードにはリファクタリングを行う。) ただし、クラス・モ
> ジュールやパブリックなメソッドには仕様をRDocス タイルで記述する。

はーいせんせー。実際の開発ではパフォーマンスとかの兼ね合いでいつもリファクタリングできるとは限りませーん。
必要なコメントは書くべきだとおもいまーす。
あと、コメントとドキュメントはまったく違うものでーす。Ruby的にはおんなじコメント文ですけどー。
そこんとこちゃんと切り分けて説明すべきではないでしょうかー。