アカウント名:
パスワード:
// コメントの始まり /* ...
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
Stay hungry, Stay foolish. -- Steven Paul Jobs
コメント (スコア:2, 参考になる)
プログラムなんてカッコイイ物は書けませんが、手間を省くためちょっとしたマクロを書いた時など、
後で見るとわからなくなることがありました。
やっぱり、コメントは重要です。
Re:コメント (スコア:2, 興味深い)
ソースコードの全行にわたってコメントを書いてあるのは逆効果ですよ。
見づらくてしかたないのです。
それでもまだ、内容が論理的なところまで叙述できてればまだ少しはいいのですが…
// 整数型変数i に0を代入する
int i = 0;
なんてコメント書かれてもね…。
誰に説明しているつもりなんだろうと。
当人いわく、新人君にもコメントの書き方の見本になるようなコメントを書いたとのこと。
見事に見本になってます。反面教師の。
# いいや。IDで。
Re:コメント (スコア:3, おもしろおかしい)
コードの質は推して知るべし。
……ええ、そっこーその仕事から逃げ出しましたとも。
# 書いたのは別の会社のまったく知らない人でした。
Re:コメント (スコア:2, 参考になる)
>見づらくてしかたないのです。
同意。
個人的には
1. 関数の頭には何行でも関数に関する説明を書いていい
2. 関数内部はいずれかに限り手短にコメントを入れる
- if文等の分岐条件に関する解説
- ミスリーディングしやすい部分の補足
- 仕様上回避できないコンパイル時警告に対する言い訳
というルールでコーディングしてます。このルールで不十分なコメントしか書けない場合はたいてい関数の作り方が腐ってます。
(ちなみ、いわゆる「しみったれた高速化」は要求されないというのが前提です)
Re:コメント (スコア:1)
*Don't just echo the code with comments – make every comment count.
あと、こういうのも
*Don't comment bad code – rewrite it.