「コメントはソースコードを表す？」記事へのコメント

あんまし関係がないと思う

[baku3393 (32616)]

「Ugly」の解釈がプログラマーと非プログラマーで異なると思います。

文法が正確で誤字の少ない簡潔なコメントが書けても、そもそもクラス名とかメソッド名とか変数名
が非直観的だったり、インデントが深すぎだったりしたら「コード」としては「Ugly」です。

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

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

むしろプアでしゃくし定規な「コーディング規約」なる法典をおしつけられて無理やりコメントを
書かされていると冗長な説明文が入った「見た目にキタナイ」ソースになっちゃったりします。

コメントもコードも「言語」ですからね。

#ってか、「非プログラマ」な人種はソースなんて見るのか？(＜俺)

--
---- ばくさん！＠一応IT土方

Re:

[Anonymous Coward]

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

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

Re:

[Anonymous Coward]

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

ケースバイケースですが、これはちょっと断定しちゃうのは反対。

SubversionやTracなりのバージョン管理なりバグ管理なりのシステムを導入して管理しろってことでしょ？
いまどきソースを日付フォルダやzipで管理してるなら、その時点で微妙だし。

＃ で、たまに古いやり方になれた人がやってきて、規約に残すなと書いてあるのにコメントアウトして残してたりする。
＃ 差分なんてツールで漏れなく正確に判るんだって！

Re:

[Anonymous Coward]

＞差分なんてツールで漏れなく正確に判るんだって！

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

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

Re:

[Anonymous Coward]

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

ツールを使いたくないのであればプログラマーとかIT業界にいないで転職した方が良いと思います。

IT業界で「ツールを知らない」「ツールを使えない」「ツールを使おうという意欲がない」というのは
ある意味決定的な問題です。自分にとっても周りにとっても。
対人恐怖症の人がカウンセラーやっているのと同じぐらい悲劇です。

IT業界人は前向きにメンドクサガリでないと:-)

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

それはツールと関係ないのでは？
気持はお察ししますが。

Re:

[Anonymous Coward]

IT業界で「ツールを知っている」「ツールを使える」「ツールを使おうという意欲がある」というのは
ある意味決定的な問題です。自分にとっても周りにとっても。
宗教家が原理論争やっているのと同じぐらい悲劇です。
#ネタですと言いきれない地獄

Re:あんまし関係がないと思う

[albireo (7374)]

そういう場合はツールを使わなくても結局同じような悲劇が起こるので安心してください。

#宗教論争をするのは「神様を信じる人」であって、神様自身は論争しない

--
うじゃうじゃ

Re:あんまし関係がないと思う

[nekopon (1483)]

仲良く立川でバカンス、というわけですね。