資料なしでコードだけ読んでわかるか？
大規模なコードになればなるほど、
細部のドキュメントは省かれるし
コードとの同期もとれなくなってくる。

半年後の自分を、新しくプロジェクトに加わった
新人だと思って、そいつにでもわかるようにコードを書け

ああ、でも、一行一行フローチャートか何かに書いてる
元COBOLERとかだったら、べつにそんなことしなくてもいいよ。
ドキュメントにない仕事すると怒られるからね。
ドキュメントを読めば、コードがわかる。
そうだろ？