ソースコードは設計書のように

凡人の凡人による凡人のためのコードライティング

凡人プログラマーの憂鬱

「新しい部署に来たけど、このコード、難しすぎ...」

(なんでこんなに読みづらいんだろう...)

「読解するのにすごい時間かかる。変数名が何を意味しているのかわからない。」

(もっと分かりやすくしてくれないかな...)

「バッチの処理を読んでるんだけど、ファイル出力している部分があるけど...」

(ファイルの仕様はどこをみたらわかるんだろう?)

「このコードを全部理解しないといけないのかな?」

(ファイルの仕様が書かれたURLはどこにあるんだろう?)