ソースのコメントでは無いが、有名オープンソースでも
びっくりするくらいドキュメントが少なくて驚くことが多い。

PicoContainer辺りは、ドキュメントは結構多いほうだけど、それでも例えば
Singletonで無いコンテナの作り方の書いてあるドキュメントはない。
Javadocを眺めると、ConstructorInjectionComponentAdapterFactoryを
使えばいいことは何とか分かる。
cglibとかはJavadoc以外には、最小限のサンプルプログラムが
1つある程度だった気がする。

たいていの人（9割？）は、やろうとする目的のために
チュートリアル、サンプルPG、Javadocまで調べて分からなければ
ギブアップするのではないかと思う。ソースまでは調べないと思う。
JavadocでAPIの仕様を見るだけ理解できるならコメントは不要だけど。

自分は、Seasarのある部分と似たものを作ったけど、Seasarのソースは
殆ど見なかった。必要も無かったし。
そう言う訳でソース読めは最後の最後だと思う。