-->
These old forums are deprecated now and set to read-only. We are waiting for you on our new forums!
More modern, Discourse-based and with GitHub/Google/Twitter authentication built-in.

All times are UTC - 5 hours [ DST ]



Forum locked This topic is locked, you cannot edit posts or make further replies.  [ 6 posts ] 
Author Message
 Post subject: Where's the tutorial mentioned in the reference docs?
PostPosted: Mon Feb 10, 2014 12:14 pm 
Newbie

Joined: Mon Feb 10, 2014 12:07 pm
Posts: 1
I'm just starting to learn Hibernate ORM, and the very first paragraph of chapter 1 of the reference documentation says:
Quote:
All code is contained in the tutorials/web directory of the project source.

It then goes on to say:
Quote:
The distribution contains another example application under the tutorial/eg project source directory.

So I cloned the project source from Github by doing:
Code:
git clone https://github.com/hibernate/hibernate-orm.git

However, the "tutorials" directory does not contain a "web" subdirectory, and there is no "tutorial" directory at all! One paragraph in and I'm finding inconsistencies!

Clearly the documentation is out of sync with the distribution, but does anyone know where I can get these (presumably old) tutorials so I can follow along with the documentation?


Top
 Profile  
 
 Post subject: Re: Where's the tutorial mentioned in the reference docs?
PostPosted: Mon Feb 17, 2014 12:31 pm 
Newbie

Joined: Mon Feb 17, 2014 12:28 pm
Posts: 1
I have run into the same problem


Top
 Profile  
 
 Post subject: Re: Where's the tutorial mentioned in the reference docs?
PostPosted: Wed Feb 11, 2015 11:23 am 
Newbie

Joined: Wed Feb 11, 2015 11:15 am
Posts: 2
I am really curious where are the up-to-date example's source code. Come on fix it!!!!!


Top
 Profile  
 
 Post subject: Re: Where's the tutorial mentioned in the reference docs?
PostPosted: Thu Feb 12, 2015 1:12 pm 
Hibernate Team
Hibernate Team

Joined: Fri Sep 09, 2011 3:18 am
Posts: 295
Hi,
it seems you have spotted an error in the documentation.
In the latest distribution package (http://hibernate.org/orm/downloads/) you can find the code for the tutorial under /hibernate-release-4.3.8.Final/documentation/quickstart/en-US/html/files/

Other examples and demos are on the github repository: https://github.com/hibernate/hibernate-demos/tree/master/hibernate-orm

I hope this help,
Davide


Top
 Profile  
 
 Post subject: Re: Where's the tutorial mentioned in the reference docs?
PostPosted: Sat Feb 14, 2015 1:57 pm 
Newbie

Joined: Wed Feb 11, 2015 11:15 am
Posts: 2
Yes, it was a great help, thanks!

Unfortunatelly, I also have found some mismatch data in the official doc (that's why I have written) :
http://docs.jboss.org/hibernate/orm/4.3/manual/en-US/html/pr01.html
"tutorial is included in the distribution in the doc/reference/tutorial/ directory. " - It seems to be not correct.

http://docs.jboss.org/hibernate/orm/4.3/manual/en-US/html/ch01.html
"All code is contained in the tutorials/web directory of the project source. " (OK, but where is that exactly? There is not a files folder under the en-US\html_single\ or en-US\html) And so on.

I would like to get the code of "HIBERNATE - Relational Persistence for Idiomatic Java" not the Getting started part's code.

Sorry, If I am wrong.

And in the Getting started code's, there are using a deprecated method: buildSessionFactory() (For example in AnnotationsIllustrationTest or NativeApiIllustrationTest) - Maybe it needs to review it.


Top
 Profile  
 
 Post subject: Re: Where's the tutorial mentioned in the reference docs?
PostPosted: Thu Feb 19, 2015 6:31 am 
Hibernate Team
Hibernate Team

Joined: Fri Sep 09, 2011 3:18 am
Posts: 295
Thanks
this is very helpful,
can you create a ticket with all the errors you have found on our JIRA: https://hibernate.atlassian.net/browse/HHH/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel

This way it is possible for us to keep track of the changes.

Cheers,
Davide


Top
 Profile  
 
Display posts from previous:  Sort by  
Forum locked This topic is locked, you cannot edit posts or make further replies.  [ 6 posts ] 

All times are UTC - 5 hours [ DST ]


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum

Search for:
© Copyright 2014, Red Hat Inc. All rights reserved. JBoss and Hibernate are registered trademarks and servicemarks of Red Hat, Inc.