関数やクラスを文書化するときには、「このコードを見てビックリすることは何だろう？　どんなふうに間違えて使う可能性があるだろう？」と自分に問いかけるといい。基本的にはコードを使うときに直面する問題を「前もって」予測したい。