14
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

KDDI EngineerAdvent Calendar 2020

Day 22

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

Last updated at Posted at 2020-12-22

はじめに

  • こんにちは ! 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  .__  _.-   
##         | |  |  ``/  /`  /
##        /,_|  |   /,_/   /
##           /,_/      '`-'
##

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

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

参考

14
2
0

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
  3. You can use dark theme
What you can do with signing up
14
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?