良いRubyコードにはコメントがないと受け入れられますか？

Question

私はRubyで書かれた専門的なコードを見直し、コメントは見つけられませんでした。このコードは読みやすいとはっきりしていましたが、自己文書化はできませんでした。専門的に書かれたRubyコードにコメントが必要なのでしょうか？または、コメントが必須とは見なされないRubyの教義がありますか？

Answer 1

この問題は、Rubyに固有の問題ではありません。

コードコメントは、コードが変更されたときには通常更新されず、参考になるよりも誤解を招くため、絶対に最低限に抑える必要があります。

あなたが既に提案したように、最良のコードは自己文書化であり、コメントは必要ありません。

編集：明確にするために、複雑さを取り除くためのコードを減らすことができない場合、はにコメントを提供する必要があります。これは私の経験ではまれなことですが、通常、外付けコンポーネントが予期したとおりに動作しない場合にのみ適用されます。

Answer 2

Rubyの作成者であるMatz氏は、「ソースコードはドキュメントであり、すべてのバグも正しく記述しています」と述べています。そして彼はおそらくコメントのためにそれを意味するでしょう。私はRubyのソースコードにコメントしていない多くの人が彼の言葉に従っていると思います。あなたが彼に従うかどうかはあなた次第です。

Ruby入門Webサイトでは、コメントする必要があると感じるたびに、その方法を個々の方法と同じように分割し、その部分をコメントするときに名前を付けるべきだという噂を紹介しました。