search
LoginSignup
1

More than 1 year has passed since last update.

posted at

updated at

Organization

これまでに出会ったことのある最高のソースコード内のコメントとは

はじめに

  • こんにちは ! KDDI アジャイル開発センターの小板橋です。
  • この記事は、あくまで楽しみとして取り扱ってください。
  • くれぐれも使用しないことをお勧めします。w

下記は、実際にプロダクションコードで遭遇したコメントです。
こちらのStackoverflowにあったものを翻訳しています。

自信喪失系コメント

// ごめん。
// お願い…動いてくれ…
// このコードは最低だ。知ってるだろ?俺もわかってるんだよ。
// 俺をバカだと呼んでくれ。
// これが機能する理由はわかりません。
// このコードが必要あるのかわかんないけど、なんか消すのがこわい
// なにが何だかわからない
// ジョー、ごめんなさい
数百行後... 
// ハリーもごめんなさい

報告系コメント

// 昼食はチキン・ベーコンラップ
// 修正するにはコーヒーが必要
// ヒューストン、問題があります
// David S.Millerによって追加されたバグです。

ToDo系コメント

// TODO: 動作させる
// TODO: もう全部消す
// todo: 実装されることはありません
// TODO: これを修正します。何を修正しますか?
// TODO: return this;

強迫系コメント

// 解雇したい場合は、これを削除します
// このコメントが削除されると、プログラムは爆発します

ふっwとなるコメント

int main(void)
/ *プログラムはここから始まります* /
// 上司の気が変わったために追加:20020111,20020501,20020820、... 
// 上司の気が変わったためにコメントアウト:20020201,20020614,20020908、.. ..
// 酔った。後で修正する。
// なんで動作してるのかわかんないけど、とりあえずここの問題は、このコードで解決した
// これは明らかに強要の下で書かれました
Catch (Exception e) {
// who cares?
}
##                               
##  _._ _..._ .-',     _.._(`))
## '-. `     '  /-._.-'    ',/
##    )                     '.
##   / _    _    |             
##  |  a    a    /              |
##     .-.                     ;  
##   '-('' ).-'       ,'       ;
##      '-;           |      .'
##                        /
##         | 7  .__  _.-   
##         | |  |  ``/  /`  /
##        /,_|  |   /,_/   /
##           /,_/      '`-'
##

このコード最強だから、いじるんじゃねえ系コメント

// これは魔法。触っちゃダメ。
// コメントは書かない
// 説明しづらい
// だから読みづらいはず
# ==== このコードいじっちゃだめ。絶対だめ。いじったら蹴り飛ばしちゃうよ ===

参考

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
What you can do with signing up
1