The query and criteria API is pretty powerful as a predicate API and query API. It does not, however, provide sufficient documentation so outside users struggle with the features.
Javadoc would be ideal at the very least. Markdown would also be useful on the package itself.