メンテナンス性の高いソース

誰もが手を入れる必要のあるソースは小難しいことをやる必要はない。
誰が見てもわかりやすいロジックで組むことが重要。
とはいえ、効率化のために高度なロジックを組みたい場合もあるだろう。
組んでもいいが、その場合は後から誰が見てもそのロジックを理解できるように、
コメントやドキュメントを残す必要がある。
「インプット・アウトプットだけわかればロジックは高度に組んでも問題ない」
という理論もあるが、ブラックボックス化された関数は気持ち悪い。
特にバグを取る時に、「原因はこの関数なのでは・・・？」という不安がつきまとう。
誰もが全体に手を入れやすくするために、可能な限り避けた方が良い。
口でいうのは簡単だけど、なかなかむずかしーんだこれが。