プログラムのコードにいちいち細かくコメントなんて書かないよね？ コメントなんて本当に必要なところにしか書かないんだが、コメントが極小だと納品先にクレームつけられたんだか。。。コード読めばわかんだろ。その為にいろいろわかりやすい名前考えてつけてんだからよ。あ、xxxdocsみたいなのでdocコメントはつけてるよ。
xxxdocsみたいなのってコメントないとほぼ意味なくない？
なんで？
コメントからドキュメントを生成するツールなのにコメントなしで逆に意味あるの？
xxxdocsのコメントは最低限書いてるよってこと。
ならその最低限のラインが低すぎるんでしょ。わざわざドキュメントつけてまでソース嫁っていう部分が理解できないんだが、そのドキュメントじゃ自分でもわからんってこと？
普通にトピ主の主張は理解出来るが。。。コメ主はなんか勘違いしているのか、よっぽどの底辺のどちらかなのだとおもわれる。
何言ってんの？君はもういいよ。
マニュアル作るか作らないか問題じゃない。コメントをマニュアルとして使うのであれば、お金もらうべき。
確かに！
コード読んで解からんバカとは仕事しないのが正解。よほどトリッキーじゃなきゃ見りゃ解る。でも関数には何の機能かぐらいは書くかな…。
ほんとコレ。ただでさえ命名に労力かけて、コードで語れるようにしてんのに、コメントつけろとか英語勉強しろとしか言いようがない。
んでそのクレーム受けてどうしたのさ？
プログラミングの入門用サンプルコードを書く仕事を請けたつもりはないから、必要最低限のコメントした書きませんでしたって言って、とりあえず保留。上のコメ主が言うように別途料金で先方が望むなら対応かな。
みんなの回答 4 件
xxxdocsみたいなのってコメントないとほぼ意味なくない？
マニュアル作るか作らないか問題じゃない。
コメントをマニュアルとして使うのであれば、お金もらうべき。
コード読んで解からんバカとは仕事しないのが正解。よほどトリッキーじゃなきゃ見りゃ解る。でも関数には何の機能かぐらいは書くかな…。
んでそのクレーム受けてどうしたのさ？
関連するトピックス