パスワードを忘れた? アカウント作成
この議論は賞味期限が切れたので、アーカイブ化されています。 新たにコメントを付けることはできません。

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

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

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

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

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

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

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

    #ってか、「非プログラマ」な人種はソースなんて見るのか?(<俺)
    --
    ---- ばくさん!@一応IT土方
    • by Anonymous Coward

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

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

      • 今時の俺のやり方だと、とりあえず改修前のソース部分(コメント含む)をコメントアウトして改修後のソース書いてSVNとかに突っ込んで、テスト実施。テストOKなら前の履歴と比較しながらコメントアウトしといた改修前の部分を消す。

        # 消したあとのソースでテストしないのって?いや、やりますよ。
        # そのときはさくっと流して初回テスト時と同じ結果かDiffだけど。

        まー、今時はバージョン管理ソフト使ってるところも多いからここまでやらんでもいいとは思うんですが、やり方をがらっと変えてバグ作り込むよりはいいかなって感じです。やってるときは前のコードも見てたいしw
        • 過去のバージョンとdiffとってみて。
          たぶんエライコトなってるから。

          やってるときは前のコードも見てたいしw

          ファイルのコピー残しとけば良いんじゃ...

          親コメント
          • by Anonymous Coward
            多分ですが・・・

            画面内、少なくともスクロールできる範囲内に前のコードを置いておくって意味だと思いますよ。
            残す目的のコメントじゃ無いでしょうから、性質が違うかと。

一つのことを行い、またそれをうまくやるプログラムを書け -- Malcolm Douglas McIlroy

処理中...