あなたが見た中で最も有用なコードコメントは何ですか？

回答 (25件中の1件目) 有用なコメントはどれも有用で、どれが一番、としづらいです。 無いと困るという視点でみると、特定のデータ構造を処理するコードのコメントです。例えば、パーサーがどういう構文を処理しているのか？といったコードはどんな構文なのか説明がないと、何を処理しているのか構文を知らない人には解りません。 postgres/postgres 手続き型言語の場合、構造体への値設定にどのような意味があるのか？は代入からでは解りません。（OOの場合はエンカプスレーションしているので、メソッド名で概ね解るようにできる） postgres/postgres コードから処理が判って...

[nui81]

エクセプション握り潰してるところに「転んでも泣かない」って書いてたのかわいかった。

[turanukimaru]

ログや printf を消すと動かなくなるコードはだいたいメモリを破壊してるか未定義動作を呼び出しているか。ログや printf のメッセージ文字列が代わりに破壊されたりしてる。銀行間システムも printf があれば生きていたかも

[raamen07]

人の入れ替えが激しいとこで「ここ直感的にはこうなった方がいいと思うけどこう言う経緯でこうなったんよ。細かいことはこのURL」みたいなのがあると猛烈に助かることがあるけど書いてあることも助かることも稀

[hryord]

「これ何で動いてるか分からない」かな。絶望と笑いしか出なかった。

[maname]

Cでログ出すと動くけれど、それ削除したら動かなくなったことはあった。あれ解決できたときすげえ感動したんだけど、原因もう思い出せない…

[Listlessness]

/* You are not expected to understand this. */ は最近なんかで見たなぁと思ったがこれだhttps://b.hatena.ne.jp/entry/s/blog.pokutuna.com/entry/oss-sightseeing-spots

[uxoru]

有用ではないけど感動して”しまった”コメントは、罫線でGUIそのものが書かれてたこと……すげぇ！って思ってしまった（メンテしたくないから消してくださいと言ってしまい、いつの間にか消えてしまった……

[lacucaracha]

『このバグはいつか直す』かな。あ…やっぱバグなんや…的なことが事前に分かって助かった（直しておいてくれたらなお良かったが）

[flirt774]

WordPress のディレクトリアクセスが不要なディレクトリに置かれているindex.php の Silence is golden は旧来文化の匂いがして好き 　https://github.com/WordPress/WordPress/blob/master/wp-content/index.php

[buhoho]

もしかしたら有用なコメントを一度も見たこと無いかもしれない。

[Nnwww]

“You are not expected to understand this.”

[murasuke]

“/* You are not expected to understand this. */ ”

[tubuan_umeeee]

/* 後で消す */

[khtokage]

自分で開発するとき、id:raamen07 さんの言うような参考URL付きコメントを出来るだけ残すことにしてます　自分でもすぐに忘れるので…　開発用のメモもあるけど、ソース見てるときにそこだけで完結するのがいいなーと

[canadie]

「ここにprintfを入れるとなぜか動く」

[udddbbbu]

納品データのコメントにクライアント担当者の悪口書いてたヤツが過去一

[UhoNiceGuy]

これ、CPUかコンパイラが変わったら動かなくならん？まぁ、そういうものか

[tick2tack]

“「なぜか分からないがこのコードを書くと動いた」というコメントは有用でした”　このコメがなければ怖くて改修できなかったと。そうだよなー

[Iridium]

概要書いてあるだけで助かるよ。設計書もない、コメント何も書いてないと全部読んで機能を推測してから想像しないといけないので、メチャクチャに時間かかる。

[yau]

/* 理由はわからないがこの行を消すと動かない */

[ardarim]

ログいれると動くみたいなのはだいたいメモリ破壊かタイミングか排他制御漏れか。いずれにしても原因特定は難しいのよね

[dollarss]

/*このブコメはあなたに理解してもらおうとは思っていません。*/ が、★を付けるのは構いません。

[junjuns7]

部長の名前が書いてあったので中身を聞きに行った

[tacamula]

理想はコメントなくても理解できるソフトウェアアーキテクチャとコード。ということを実現できたらいいなぁと常々思ってコメントを書いている | 抽象度が違うものへの言及はコメントがドキュメントにするのが次善か

[Knoa]

/*これどういう意図だっけ？*/

[versatile]

実際に関係なさそうなコードなのにいれるとそれ以降がうまく動くってのは何度も経験したし、そういうコメントを残したこともある。おもに C++ とか MFC のコードを書いてるときにそういうのと遭遇した

[aaa_too_zzz]

消すと動かない

[shaokuz]

//何故か動く

[nanakoso]

C