17/01/23 10:27:38.06 BqV6mX3Z.net
>>503
そうだねぇ
関数名や変数名を見れば自明なことまでコメントに書いてあってうんざりしたり
反対に、
関数名や変数名を雑につけてるから意図を読み解くのが大変だったり
コメントには意図や目的を書いてくれれば十分だと思うよ
5W1H のうち、What, Who, Where, When, How はコードのなかに詰め込めるけど、Whyだけがコードでは表現できない
だから、コメントにはWhy (意図や目的)を重点的に書いて欲しい
反対に
コードには残りの4W1H(What, Who, Where, When, How)を詰め込むように心掛けたい
キレイで美しいコードになるから
技量的に無理なときはコメントで補完ねw