気に入った記事をブックマーク
- 気に入った記事を保存できます
保存した記事の一覧は、はてなブックマークで確認・編集ができます
- 記事を読んだ感想やメモを書き残せます
- 非公開でブックマークすることもできます
エントリーの編集
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
記事へのコメント261件
- 注目コメント
- 新着コメント
NOV1975
そもそも「処理の内容」はコメント文化であってもコメントすべきではない。たまに「変数aに引数xの値を代入する」とか書いてあってクラクラする。そうじゃなくてコメントに書くべきなのはその処理になっている理由
practicalscheme
この仕様を実現するのに通常はAやBという手法を使うが今回のケースに限っては何某が何年に出したこの方法の方が性能が出たのでそれを使った。詳しくはこの論文参照、っていうようなメタ情報はどこに書くの?
vanbraam
方法論としては理解できるし各論はおおよそ同意するが,原理主義は苦手;コードに関する情報はコードに近い所に,が原則だと思うので,JavaDocの様なdocumentation commentsは許されるべき派
tettekete37564
“「コメントが無くても読めるようなプログラムを書け」”<ダウト。高級言語ならコードは読めて当たり前。問題はどんな目的を達成する為になんでその処理を行っているかがわからないとエンバグや改修・保守時に地獄
j5ik2o
Docコメントに限っていえば仕様を記述する意味があると思う。例えばそれがバグかどうかは実装コードをみても仕様が明示されないと基本的には判断不能。詳しくはメイヤー本の契約による設計を参照してほしい。
BT_BOMBER
文化というかメンバーの実力が全員十分なら通用する話。実際には開発規模が大きくなるとレベルが落ちる人も入れざるを得ない場合が出てくるはず。少数精鋭で一定以下の開発規模でないと難しいと思う
ite
コードがどんなに良くても、それは基本的にHowを書くためのもの。Whyを書けるのはコメントで、それは設計やデザインに近い。プログラムにコメント書かない文化があるのは結構だが、私はそこに関わりたくない
rti7743
動くけどコメントが一切ないソースコードといえば、逆汗したアセンブラだが、コメント内からソースを読みまくってwhy?を探るためにとても苦労する。なぜそう書くのかはコメントを入れてほしいなあと。
tockri
abstractとかtraitとか、抽象度がいろいろ変わりながらたくさん書くときに最初に考えてたこと忘れちゃうので、メソッドの中身を作る前にコメントに「○○のために○○する」って書いてる。コメント駆動開発。
quick_past
なぜこうしてるのか、はそのメソッド内かせめてクラス内で閉じてるならまだしも、外のクラスやフレームワークなどの仕様変更で振る舞い変わっちゃうとコメントだけ修正しわすれが発生したりするのがめんどい。
注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています
いまの話題をアプリでチェック！
- バナー広告なし
- ミュート機能あり
- ダークモード搭載
関連記事
プログラムにコメント書かない文化もあるよって話｜NZ MoyaSystem
以下の記事を読んで。 530000micro.hatenablog.com 僕が勤めている会社では、原則、プログラムにコメン... 以下の記事を読んで。 530000micro.hatenablog.com 僕が勤めている会社では、原則、プログラムにコメントを書かないのがルールです。 人生で初めてプログラムに触れてからこのかた、プログラムには必ずコメントを書けと指導されて来ましたし、自分自身も、後輩たちにちゃんとコメント書けよと言い聞かせてきました。そんなわけで、最初に全然コメントのないソースコードの山を見たときは、正直「ゲッ、なんじゃこりゃ……」と面食らったのは確かです。 ところが、「なぜうちのプログラムにはコメントがないのか？」と同僚に尋ねてみると、実に納得の行く回答が返ってきたのでした。 なぜコメントが必要なプログラムを書くのか？ 同僚いわく、「コメントが無くても読めるようなプログラムを書け」という思想が根底にあるのだそう。 適切に関数や変数が命名され、スコープがきちんと管理され、ロジックの流れが整理されているコ
ブックマークしたユーザー
すべてのユーザーの
詳細を表示します
詳細を表示します
2016/04/22 リンク