Re: [hibernate-dev] ORM documentation info hibernate.org

2018-02-07 Thread Steve Ebersole
That's a good thought. On Wed, Feb 7, 2018, 3:52 PM Sanne Grinovero wrote: > No strong objection, but I quite like it giving a quick shortcut to > switch version. > > It's also well visible, making sure people are on the version they > mean to be - which is useful if they "land" directly on a ve

Re: [hibernate-dev] ORM documentation info hibernate.org

2018-02-07 Thread Sanne Grinovero
No strong objection, but I quite like it giving a quick shortcut to switch version. It's also well visible, making sure people are on the version they mean to be - which is useful if they "land" directly on a version documentation from outdated links or search engines. On 7 February 2018 at 18:

Re: [hibernate-dev] ORM documentation info hibernate.org

2018-02-07 Thread Vlad Mihalcea
I also think it's redundant now. Vlad On Wed, Feb 7, 2018 at 8:36 PM, andrea boriero wrote: > I think it is not necessary anymore, so +1 for removing it. > > On 7 February 2018 at 18:32, Steve Ebersole wrote: > > > Now that the hibernate.org infrastructure supports doc versions, should > we >

Re: [hibernate-dev] ORM documentation info hibernate.org

2018-02-07 Thread andrea boriero
I think it is not necessary anymore, so +1 for removing it. On 7 February 2018 at 18:32, Steve Ebersole wrote: > Now that the hibernate.org infrastructure supports doc versions, should we > remove the version drop-down from the info pages? Vlad I know you spent > some time adding that; what are

Re: [hibernate-dev] [ORM] Documentation inconsistencies

2017-08-29 Thread Vlad Mihalcea
Hi, The inconsistencies are due to the latest release being done quite a long time ago. The 5.2 User Guide was generated when we released 5.2.10 while the GitHub repo contains many doc changes that will be available only when we release 5.2.11. Vlad On Tue, Aug 29, 2017 at 8:12 PM, Marko B wro

Re: [hibernate-dev] ORM Documentation

2015-08-14 Thread Steve Ebersole
The one drawback to splitting out a mapping guide from the user guide (and it is a big one) is the inability to link to discussions in the user guide, and vice versa. Instead I have to keep saying things like "For details see XYZ in the Hibernate User Guide". I would imagine, as a user, that woul

Re: [hibernate-dev] ORM Documentation

2015-08-03 Thread Steve Ebersole
Well Identifiers in the mapping guide still needs some work. I guess move that into category (b). TBH I do not know how much of "derived identities" I will document this time around. If someone more familiar/comfortable with explaining that stuff wanted to take a shot I would not argue :) On M

Re: [hibernate-dev] ORM Documentation

2015-08-03 Thread Steve Ebersole
So the documentation is getting along. If people could start looking it over that would be great. If people are willing to pick up remaining topics, even better! So the 2 old docs (manual and devguide) are now 3 much more focused docs: 1) Hibernate User Guide - much of the information from the

Re: [hibernate-dev] ORM Documentation

2015-07-30 Thread Emmanuel Bernard
I think topical guides never got traction because the work on doc was down to zero. I would not give up hope on them :) > On 28 Jul 2015, at 19:51, Steve Ebersole wrote: > > So tentatively I have the following docs: > > 1) "User Manual" - mostly done > 2) "Domain Model Mapping Guide" - work in

Re: [hibernate-dev] ORM Documentation

2015-07-28 Thread Steve Ebersole
So tentatively I have the following docs: 1) "User Manual" - mostly done 2) "Domain Model Mapping Guide" - work in progress, but progressing nicely. 3) "Integrations Guide" - atm this will be just the devguide with the Service+Registry chapter; but I'd like to circle back and pick up other topics

Re: [hibernate-dev] ORM Documentation

2015-07-27 Thread Steve Ebersole
Sanne, yep thats why I sent the second email with a link ;) Anyway.. I just pushed some initial work on the manual. Its not complete yet. And I still need to start on the mapping guide. Let me know any thoughts y'all have. On Mon, Jul 27, 2015 at 2:31 PM Sanne Grinovero wrote: > I didn't r

Re: [hibernate-dev] ORM Documentation

2015-07-27 Thread Sanne Grinovero
I didn't receive an attachment. AFAIK the mailing list drops them? On 27 Jul 2015 14:39, "Steve Ebersole" wrote: > I have been putting a lot of TLC into the ORM documentation this weekend > getting ready for 5.0 to go Final. To that end I have put together a > proposal for these changes, it is a

Re: [hibernate-dev] ORM Documentation

2015-07-27 Thread Steve Ebersole
Forgot our list strips attachments :) https://github.com/hibernate/hibernate-orm/wiki/Documentation-proposal On Mon, Jul 27, 2015 at 8:38 AM Steve Ebersole wrote: > I have been putting a lot of TLC into the ORM documentation this weekend > getting ready for 5.0 to go Final. To that end I have