スラッシュドット・ジャパン

> 逆に、何にもコメントがなくてもコード自体が短くて直観的でコメント自体が不要なものであれば
> 「美しい」コードだったりします。

内容は賛成ですが、万人にはお勧めできないと思います。
「自称」やり手プログラマの中には、
コメントがなければ美しいコードだと勘違いしている人がいるようなので。

以前、ソースコードにコメントがなくて理解できないことを書いた本人に言うと、
「コメントがなくてもわかりやすく書いてある」
と言っていたのですが、そのソースコードの不具合改修をお願いすると
「書いてから時間が経っていてプログラムを解析する必要があるので、修正するには時間がかかる」
と言ってました。
そのためのコメントじゃないの？

同様に「プログラマならemacsだろ！IDEなんか必要ない！」みたいな考え方の人もどうかと思います。

＞＞ あと、修正前のコードをコメントアウトして残すことを強制されたコードも「Ugly」。
＞＞ バグ票番号を修正箇所にゴチャゴチャ残させるコードも「Ugly」。

＞ケースバイケースですが、これはちょっと断定しちゃうのは反対。
＞修正後のコードに問題が無いかの検証をするのに残すべき、という場合もあります。

十数年前だったら、それも一利あったかもしれない。
当時でも否定する意見は多かったけど。

今だとこれはバージョン管理システム＆バグトラッキングシステムで行うべきもの。
未だにそれを導入してない／導入したけど使ってないというのは、バカがすること。

「日本ではバカが非常に多い」という点については、残念ながらその通りというほかない。

えー・・・ネタだよね？ 一応突っ込んどくけど、

技術者って皆、口をそろえて「XXX使えばわかる」って言うのよね。
それって「ツールを使わなきゃ差分すらわからない」と同義でしょ。
ツールなぞ使わずシンプルにソースだけで把握できることにメリットって感じないのかなぁ。

「共有フォルダに最新ソースがあります。修正前後の差分はコメントを見れば判ります。」
と言われて引き継いだら、src_20091117 と src_最新版 と src_最新 フォルダがあったらどうしますか？
ついでに、コメントは基本的に適当デタラメだったらどうしますか？

そうやって自力で管理することを放棄して、作成者にしか理解できないソースばかり生み出すのよね。
あんたらが飽きて放り出したソースの尻拭いしてやってんだ。コメントぐらいふんだんに残せよ。

バージョン管理システムやバグ管理システムは、作成者が更新しますが、最終的に管理者が管理するものですよ。
管理者の人が管理しなかったら、作成者にしかわからない状態になりますが、それは自業自得ですね。

＃ ちなみに全部実話です（涙

・diffを使うのはずるい
・それは実力ではない
・仕事が早いというのは同じ環境でどれだけ間違いがなく効率よく作業ができるかだ。
・ツールを使うのはズルとしているのを同じ
ということでしょうか [okwave.jp]

# ○○な処理。。。なんだけど、うまく動かない。

ってコメントには怒りを通り越して笑うしかない(笑)

詳細なコメントは、それ自体へのメンテナンスコストがかかるので、コメントが不要なくらいに理解しやすいコードを書くというほうに努力すべきだと思います。
# 昔 Linux-Users-ML でそんなスレッドがありましたよね。

客先からメンテを依頼された某パッケージソフトの例

// ○○が変更しろというから変えたら
// 間違っていてやっぱり戻せと言われた
// ○○め！

#直接言いなさいよ……

>// とりあえずちょっと多めに
>ちゃんと計算しろ。
>// よく分からんけど参考例をコピペ
>理解してから。
>// おまじない
>聞かないことが多い。

>とコメントしたことがある。

ちゃんとコメントアウトしようよ

うしろから羽交い絞めにして、
「やめろ、やめるんだ!!」
「はなせっ離してくれっっ、ここを最適化しないと…ここを最適化しないとっっ」
「ばかっ、そこで苦労してどうする。今じゃもう、gcc とかの最適化がそんな事は全部やってくれるんだっっ」
「な…なんだって…　じゃぁ、俺の今までの苦労は…」

うん。もう同情に涙が止まりませんよ。gccの最適化の強靭さを見た瞬間の感動を君にも分けてあげたい。

.

ただ、そのためにコードを読みにくくするのは昔のコードであってもお勧めできません。

「アセンブラで組め」
「インライン　アセンブリコードで組め」

で、コメントにCの読みやすいコードを書くんだ。
「いつか、良いコンパイラが出てきたら、このアセンブリコードは破棄するように」
というコメントをつけて。

そうやって、コードもコメントも完璧なソースがコンパイルもされずに誰かのハードディスクの片隅から納品後に見つかるんですねわかります

ソース内だけじゃなく外部管理もちゃんとしてくださいよ！！！