JavaDoc用コメントに長文で詳細設計を書くのが普通です。
おまえら書いてるよな?