[hibernate-issues] [Hibernate-JIRA] Commented: (HHH-3848) Hibernate.org documentation is out of date

[Adam Brod (JIRA)]

    [ http://opensource.atlassian.com/projects/hibernate/browse/HHH-3848?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=33088#action_33088 ] 

Adam Brod commented on HHH-3848:
--------------------------------

This is still a problem on the live hibernate.org website.  I'm not sure that this bug really affects Hibernate 3.5...

For example, the Cache class is deprecated in Hibernate 3.3, but this link doesn't show the class being deprecated: https://www.hibernate.org/hib_docs/v3/api/org/hibernate/cache/Cache.html

As of today, this is the class description on the website: 

Implementors define a caching algorithm. All implementors must be threadsafe. 

Whereas in the 3.3 source, the javadoc reads:

*Deprecated. As of 3.3; see for details.*

Implementors define a caching algorithm. All implementors must be threadsafe.

> Hibernate.org documentation is out of date
> ------------------------------------------
>
>                 Key: HHH-3848
>                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-3848
>             Project: Hibernate Core
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 3.5
>            Reporter: Adam Brod
>
> The Hibernate Core API documentation is out of date.  It appears to be from Hibernate 3.2.x.  In Hibernate 3.3 most of the cache API was deprecated.  Online, there is zero documentation for the new APIs.  By downloading the source I can see there is some javadoc.  The updated docs should be posted to the website.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira