Seasar のドキュメントは
一見してソース・サンプルが多数でとっつきやすそうなんだけど
設計思想がさっぱり語られてない。
ソース読めばどうなるかは分かるけど、
意図してそうなってるのか、たまたまそう実装されたのかは不明。
主要な interface に絞って詳細なドキュメント書くだけでも随分良くなる。