CPANのすごさ

http://www.typemiss.net/blog/kounoike/20060119-53
http://www.typemiss.net/blog/kounoike/20060120-54
そう。ドキュメントではSYNOPSISが重要で、これがあるか無いかで全然理解のし易さが変わる。JavaRubyのドキュメントより.NETやPerlのドキュメントの方が全然分かりやすいのはそのためだ。
まず最初に重要なことや要約を伝え、後々詳細を伝えるのがセオリー。というか常識だと思うのだけれども、何故それができないのだろうか・・・?