開設11年の老舗まとめサイトです。レス・コメントの評価機能、アンカー機能付き

移転のお知らせ

当サイトは2018年10月3日より、https://beasoku.comへ移転いたしました。

お気に入りやブックマークなどに登録されている方は、お手数ですが下記の新アドレスへの変更をお願いいたします。

■変更前:https://vipvipblogblog.blog.fc2.com/
■変更後:https://beasoku.com

これからも、皆様のお役に立つ情報のご提供や、内容の充実に努めてまいります。
今後ともベア速をご愛顧賜りますようお願い申し上げます。

当ブログの人気記事(週間)

オススメサイトの更新情報

Menu2
 

アホ「プログラムにコメント書けよ」 俺「ソースコード読めよ」

1: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:54:21.008 ID:CsaE9fQQ0

ソースコード読めば何に使ってるかわかるだろ



★当ブログ関連オススメ記事

【プログラマー板】印象に残ったコメントを晒せ

https://vipvipblogblog.blog.fc2.com/blog-entry-289.html


★他ブログオススメ記事
51: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:23:41.578 ID:LXBqxbpd0

>>1が低能なことだけはわかった



2: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:54:49.228 ID:nz2ka1nZ0

お前のコード汚い



3: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:54:51.262 ID:HR9JOl3dd

でもコメント読めば一瞬じゃん



6: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:55:00.002 ID:HTazAekrp

書けば読まなくて済むだろう



8: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:56:04.385 ID:rA0CZOF90

// analにunkoを代入
anal = unko;

見りゃ分かるわ



47: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:22:04.291 ID:lSKB1XWy0

>>8
排泄しろや



9: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:56:54.395 ID:CsaE9fQQ0

やはりアホが多かった



10: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:58:03.849 ID:KwHWI0EVa

アホはお前定期



11: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 15:59:08.410 ID:p7eLuhTDd

コメント入れないやつはセンスない



13: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:01:20.671 ID:uUDJH5pe0

サブルーチンは普通コメントを書く

あと、変数がイミフで何やってるかわからないとか
ループ重ねすぎて意味わからんとか

いろいろあるからできるだけコメント書け



14: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:02:13.414 ID:CsaE9fQQ0

世の中はアホが多いじゃん?大体多数の言っている事はアホ



26: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:08:26.709 ID:XKY7pLFB0

>>14
アホが多いならなおさらアホにもわかるようにコメント書くんだろ
何故アホにソースコードを読ませようとするのか



28: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:09:32.876 ID:1XcQfzNSp

>>14
だからコメントが必要な訳で
お前はバカが書いたコードをメンテした事無いの?



15: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:02:21.376 ID:poEDrt7Pp

コメント書かない奴のソースが読みやすい綺麗なコードだった試しがない
ネーミングセンスはおろか命名規則さえろくに守ってない
三重ネストは当たり前、関数1つで100行はざら
綺麗に書くのはおまえには難しいだろうからせめて日本語だけでも書いてくれと言えば何を勘違いしたのかドヤ顔でソース見りゃわかるだろとかもうね



36: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:17:49.848 ID:yDVO3iel0

>>15
これwww



42: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:21:03.129 ID:1XcQfzNSp

>>15
3重ネスト、100行の関数とか温いな~
5段のループ(if文入れたら最深部は9段ネスト)、平均3000行(最大1万行)の関数、とか実在するからな



46: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:21:54.388 ID:ceEpIFxC0

>>42
こわい



16: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:02:26.462 ID:1XcQfzNSp

分かりにくいものはコメント必要
分かりやすいものはコメント不要
こういう柔軟性がいるのに何故か全部にコメントしたり一切コメントしないかの2択で争うのがバイナリ脳



17: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:02:29.743 ID:wMjXvruVd

わかる!!!



18: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:03:35.724 ID:rA0CZOF90

コード書いてるとき俺「ソース見りゃわかるだろ」ドヤッ

数ヶ月後コード見直した俺「」



176: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 18:09:53.459 ID:dvEGgJRxM

>>18
これ



19: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:04:11.189 ID:uUDJH5pe0

1年前に自分が作ったプログラムを見ると、コメントの大切さが痛感できる



20: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:05:07.537 ID:Pb5Ee/Ika

/*_*/



22: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:06:31.800 ID:zoun77hK0

見返す時にソース読み直して理解するよりコメントで理解する方が圧倒的に早いだろ
何言ってんだこいつは



23: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:07:56.882 ID:wdp+3hWS0

わざわざくっそ長くて汚いソース読むよりコメント読む方が時間短縮になるだろ



25: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:08:22.888 ID:CsaE9fQQ0

昔自分で書いたソースなら読み返せばすぐにアルゴリズム思い出す
まあ昔のソースなんてそんなに読まないけど
複雑な処理のやつならアルゴリズム読み返すけど



27: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:09:22.609 ID:rA0CZOF90

何をしているのかはコードを見れば分かる
何故そうしたのかはコードを見ても分からない(時がある)



34: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:17:38.176 ID:0+UumX/fp

コード読むよりコメント読んだ方が早いだろ
いちいち他人にコード読ますなハゲ
本人しかわからん俺様コーディングするなよ迷惑



38: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:18:32.681 ID:8uFwL8Bca

割りとマジで、書いた人がいなくなったあとのソースにコメント書いてないパターンはヤバイ


それはそれとして別になくてもわからなくはないけど、コメントちゃんと書いてるほうが工数減らせるよね?



39: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:19:35.646 ID:CsaE9fQQ0

例えばソートのアルゴリズムにコメントはいらんだろ
あんな簡単なアルゴリズムにコメントなんていらん



41: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:20:59.949 ID:8uFwL8Bca

>>39
複数人で組むときに、毎回これなんだろーって読むよりも関数の頭のコメントだけで足りるようにするほうが
作業スピード絶対はやいよね?



43: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:21:04.029 ID:N6CgGRaD0

みんなぁ、素人さんをいじめちゃアカンよぉ~(´ω`)
彼はまだ何にもわかってないんだから



44: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:21:24.738 ID:65DSJuyv0

複雑すぎるループは凡人には理解できないからな
本人いないと対応できないことがあるらしいって業界のやつに聞いた



54: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:24:19.900 ID:CsaE9fQQ0

>>44
再起とか使ってるソースはわかんねえ
動かして動けばいいってレベル
コメントとかそういう次元じゃない



50: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:23:23.036 ID:0+UumX/fp

誰も英語でコードの説明しろとか言ってんじゃなくて日本語でメモ書きしとけって言ってんだよ
なんでそれすら拒むんだ



52: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:23:45.616 ID:kWGB2FWn0

こういう馬鹿がブラックボックス作るんだよ



55: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:24:21.882 ID:HzjDeUk00

コメント不要でソース見ればわかるということはインポートするライブラリやクラスのdocもいらないってこと?



56: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:24:38.419 ID:sG7J67MR0

1行ごとのコメントじゃなくブロック単位で何やってるのかのコメントだぞ?



58: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:27:03.955 ID:+f3Qh9gN0

逆コンパして全部自分の目で確かめないモジュールは使わない



59: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:27:06.688 ID:8uFwL8Bca

(こういうとき、マイコンのプログラミングメインだと微妙に噛み合わない……



60: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:27:08.974 ID:+w9zjRPl0

コード読んで何をしたいか理解するよりも最初にコメントで何をしてるのか書いてあるほうが時間も手間も省けるだろ



63: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:28:55.724 ID:+f3Qh9gN0

人とやるなら品質保証も含めてはじめて作業完了だぞ
ソースみなきゃいきえないようなのはNG



68: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:30:26.363 ID:LZyMuY2jd

ソースコード見ても作った本人に聞かないと分からないとか言ってるヤツはアホ

作った本人にも分からないぞ
ソースは俺



73: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:33:11.047 ID:pDKJKrwza

>>68
作って3ヶ月もしたらコメントないとイミフ過ぎて再度理解するのに無駄な時間取られるよな



76: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:33:45.638 ID:zoun77hK0

理解出来る出来ない云々の前に工数短縮について触れないあたりお察しレベル



78: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:34:05.317 ID:0+UumX/fp

ロクなコードも書けねえのにプログラマー気取りでコメント書かないバカが
この先どこかの会社に来ると思うと会社が気の毒



80: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:35:26.506 ID:CsaE9fQQ0

わかったよバカ
コメントくらい書くよ



87: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:38:34.484 ID:0+UumX/fp

>>80
仕様書と設計書も忘れずにな



84: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:37:26.093 ID:jB79sc1Qp

有能ぼく「設計ドキュメント残せ」



89: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:39:40.037 ID:CsaE9fQQ0

なんでこんなに先輩プログラマーたちは怖いんだよ!



93: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:41:02.098 ID:65DSJuyv0

>>89
ここはまだ優しいで、専門板いくとこんな質問フルボッコやぞ



90: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:39:47.815 ID:N6CgGRaD0

まあ流石にわかりきってるのに1行1行コメント書く奴もアホだとは思うがw



92: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:40:35.934 ID:4kt2zU6KM

ドキュメンテーションコメントは残せ
他は可読性を悪化させるから残すな



96: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:42:20.626 ID:qSF293Wbd

コメント0のソース渡されて直せと言われた時は発狂した



104: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:51:26.719 ID:jB79sc1Qp

ソースコードいくら読んだところで、「何が実行されるか」しかわからなくて
「何を実行しようと設計したか」はわからんからな



106: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:52:08.934 ID:o6nSwPPl0

コメント見るだけで書いた奴のレベルが分かる



108: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:52:38.655 ID:8uFwL8Bca

読み解くよりコメント読んだほうが早い
早いということはその分早く帰れる
早く帰れるということはその分寝れるということなのだ…



117: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 16:57:07.498 ID:65DSJuyv0

コメント書いてても数十行にも渡って日本語不自由なコメント書いてるのも害悪だけどな
臨機応変に対応しないと



124: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:00:18.435 ID:r08FJY9zp

ソースコードに直接コメント書かないで
別添ドキュメントにまとめるという手はないのか



125: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:01:25.601 ID:o6nSwPPl0

>>124
それは仕様書であってコメントとは呼ばない



139: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:11:10.769 ID:jB79sc1Qp

>>124
実装レベルの記載をドキュメント管理するとメンテ工数が増大する
ソースとコメント一緒にメンテするくらいなら大した工数ではない
ドキュメントが欲しければドキシジェンとかで吐けばいい



180: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 18:15:30.406 ID:+f3Qh9gN0

>>139
実装レベルのドキュメントがないのにつくりはじめるのが工数が増大する原因だよ



194: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 19:13:56.691 ID:jB79sc1Qp

>>180
まあね詳細設計もまずドキュメント化するのが理想的ではある
実装する前にコメントから書くという手もあって、コメントが詳細設計ドキュメントですはまああり
コメントだけありゃドキュメントは生成できるし



143: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:17:46.727 ID:izx5SpPMa

自分で組んだソースを時間経ってから読み返すと意味不明になる場合が多いからコメントは書くべき



144: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:18:04.557 ID:LZyMuY2jd

VBA使い俺、変数関数名に日本語を使う事で可読性の強化に成功

可読性は上がったよ



146: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:19:39.217 ID:GkHw/SV/0

// TODO : 来年書き換える
$year = 2017;



149: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:21:31.812 ID:X2c/ZYJh0

一人でやってるなら自分の責任で書かなくてもいいけど、
チームでやってるならお前の言ってるのは独りよがりもいいところ



157: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 17:29:37.108 ID:hMqDSDkc0

日本語でコメント書くやつ何なの?
保守する人が日本人じゃなかったらとか考えないの?



187: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 18:37:06.098 ID:ipaQYXSZp

コード見るのはプログラマだけじゃないからな



191: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 19:02:48.740 ID:n2Fm9s5qd

コメントより変な名前つけるのやめろ



192: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 19:06:48.833 ID:keR/DCnsp

実装した理由をコメントにしろ定期



193: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 19:10:19.797 ID:5Pogjd1jM

ソースコードに書けないこと書くんだよ

「最後まで正しい仕様を確定できなかったので暫定でこの挙動にする」とか



195: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 19:20:57.059 ID:jB79sc1Qp

ヘッダーやらプロトタイプ宣言やら空の関数だけ書いて
べたべたコメントつけりゃそれは立派な詳細設計書である
あとは体裁だけの問題



199: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 21:13:48.209 ID:ExYVTt/9a

C言語から入った人はソースを読む文化があるのでコメント書かない
JavaやC#などのオブジェクト思考から入った人はコメントを強要してくる



201: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 21:29:03.319 ID:whaWSsvB0

>>199
Cで止まってる奴の間違いだろ
C出身は警戒しろは不文律だと思ってたけど



204: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 23:34:17.012 ID:U+ZMUDqd0

最小限のコメントは必要
後は命名と整形とコード自体の綺麗さ



205: 以下、\(^o^)/でVIPがお送りします 2017/06/22(木) 23:35:25.107 ID:7JYPUSVea

リーダブルコードもコメントに言及してるけどな
可読性は正義

コメントを含めありとあらゆる手を尽くすべき



208: 以下、\(^o^)/でVIPがお送りします 2017/06/23(金) 02:07:16.096 ID:QzwgVaci0

まあ、最終的にはコメント書いた方が読みやすいという人が多数の職場なら
書くように決めればいいし、コメントあると読みにくいという人が大多数ならコメント
書かないよう決めればいいだけ



210: 以下、\(^o^)/でVIPがお送りします 2017/06/23(金) 02:12:58.138 ID:RiiOM7AWa

同僚に作文かwってほどコメントをかくやついるが
ぶっちゃけ周りからの評価高いんだよな
もちろん嫌いなやつもいるが



211: 以下、\(^o^)/でVIPがお送りします 2017/06/23(金) 02:17:10.235 ID:Gmi+A5uL0

C++のSTLやJavaやC#の便利機能にどっぷり浸かって思考停止してるプログラマはソースコード書けても読む頭が足りないからしゃーない



引用元: http://hebi.5ch.net/test/read.cgi/news4vip/1498114461/

関連記事

* Category : 社会・仕事

* Comment : (4) * Trackback : (0)

* by 名無し@ベアード
if (comments.isEmpty && source.isReadable) {
you.engineer = true
} else {
you.engineer = false
you.leaveProject()
you.findOtherJob()
}

* by 名無し@ベアード
こういう非生産的なタイプっているよな

* by 名無し@ベアード
コメントに関しては何故?とか初見でん?意味わからん、ってなる部分だけだな、書くの。特に仕様よりのビジネス的な理由のとことか。

バカのために書いてあげなきゃいけないって言うより、、バカはコメントのメンテをしなかったり、コメントだけ読んでさらにそれを曲解したりするからね。。結局正確なコメントはコードと同義なものになるし。
だからおれは、バカのためにもコードと冗長になるようなコメントは極力書かない、が正解だと思ってる。

* by 名無し@ベアード
>>18
ほんとこれ

オススメサイトの更新情報

オススメサイトの更新情報

コメント

まだコメントされていません。コメントお願いします><
名無し@ベアード 2018/04/07 (土) 20:08

if (comments.isEmpty && source.isReadable) {
you.engineer = true
} else {
you.engineer = false
you.leaveProject()
you.findOtherJob()
}

名無し@ベアード 2018/04/07 (土) 22:59

こういう非生産的なタイプっているよな

名無し@ベアード 2018/04/07 (土) 23:31

コメントに関しては何故?とか初見でん?意味わからん、ってなる部分だけだな、書くの。特に仕様よりのビジネス的な理由のとことか。

バカのために書いてあげなきゃいけないって言うより、、バカはコメントのメンテをしなかったり、コメントだけ読んでさらにそれを曲解したりするからね。。結局正確なコメントはコードと同義なものになるし。
だからおれは、バカのためにもコードと冗長になるようなコメントは極力書かない、が正解だと思ってる。

名無し@ベアード 2018/04/09 (月) 12:15

>>18
ほんとこれ

コメント投稿

(空欄だと「名無し@ベアード」になります)

「>>レスNo」で本文レスへのポップアップ付きアンカーコメントになります。

「※コメントNo」でコメント欄へのポップアップ付きアンカーコメントになります。

URLが含まれると投稿出来ませんのでご注意ください。

他ブログオススメ記事

他ブログオススメ記事

アクセスランキング ブログパーツ