I find the the Hibernate JavaDocs pretty bad.
Many descriptions are too simple. Some method parameters are not even listed.

example:

public Serializable save(String entityName,
Object object)
throws HibernateException
...
Parameters:
object - a transient instance of a persistent class
Returns:
the generated identifier

(entityName is missing)