Rubyスタイルガイドを読む: コメント、アノテーション、マジックコメント

こんにちは、hachi8833です。前回の命名編に続き、今回のコメント編も英語圏に寄った指示が多く見受けられます。 このセクションで興味深いのは、「コメントを増やすよりコードを改善せよ」というメッセージ自体が繰り返し主張されていることです。 こうした指示は、本来であればそれこそスタイルに1行書いて簡潔に終わらせたいところだと想像できますが、どれほど口を酸っぱくして指示しても、結局多くの人が残念なコメント記法を使ってしまっているということなのでしょう。 Rubyスタイルガイドを読む: 総もくじ 前回: Rubyスタイルガイドを読む: 命名 次回: Rubyスタイルガイドを読む: クラスとモジュール(1)構造 コメン … 続きを読む Rubyスタイルガイドを読む: コメント、アノテーション、マジックコメント