After searching the 'net for some documentation on the upcoming and much touted JEE5 persistence API I couldn't help noticing the
ABSOLUTE ABSENCE OF API DOCUMENTATION
on the whole of the javax.persistence package. Probably the most popular, and awaited package from the whole JEE5 stack has no documentation.

This is sub par from Sun and the persistence API spec. Am I the first one that thinks this is a serious oversight? Will this not hinder adoption of the persistence API?

Lot's of people rightfully criticize open source projects for not writing (enough) documentation. I know the Wicket documentation could be better, but at least our API docs are quite solid.