Hi, I can surely take a look on this. We just need to discuss which task has higher priority: this one or finishing the User Guide.
Since we have a single HTML doc, we could, at first, have an upper toolbar with all currently supported doc versions: 5.1, 5.0, 4.3, 4.2 By default, we load current which is the latest version. When the user clicks 4.2, we just go to http://docs.jboss.org/hibernate/orm/4.2/manual/en-US/html_single/ If he clicks 5.0, we go to http://docs.jboss.org/hibernate/orm/5.0/manual/en-US/html_single/ If he clicks 5.1, he navigates to http://docs.jboss.org/hibernate/orm/5.1/userguide/html_single/Hibernate_User_Guide.html Is this what you were thinking of too? Vlad On Tue, Feb 16, 2016 at 8:54 PM, Emmanuel Bernard <emman...@hibernate.org> wrote: > +1. I like the idea to land on current by default and be able to go to > older versions of the documentation section if requested. > > It will require some work but I do think that it is doable in Awestruct. > > Maybe Vlad could spend some time mocking a website in that configuration > and once we converge start working in the Awestruct implementation. > I would rather see Vlad working on it as he is our doc focused expert. > Davide and I can offer Awestruct assistance of course. > > > On 12 févr. 2016, at 19:12, Steve Ebersole <st...@hibernate.org> wrote: > > > > Emmanuel, Davide, etal... > > > > I think I want to redo that decision to put versioned links on the nav. > > That was always just a temp solution, as it was the easiest way to add > > handling for versioned docs. But as I add 5.1 docs we would now have 4 > > links on the nav for docs. That's starting to get fugly. > > > > Instead I'd like to have one link (Documentation) that points to a page > for > > "current" documentation. Then from that page (and all the versioned doc > > pages) I'd like to have a set of links to older docs (or docs by > version). > > Ideas on how to best achieve that in our website build? > > > > > >> On Fri, Feb 12, 2016 at 12:05 PM Steve Ebersole <st...@hibernate.org> > wrote: > >> > >> Vlad, today I will work updating the website for ORM. Versioned > >> information (documentation) is very difficult to deal with there (imho) > >> > >> On Fri, Feb 12, 2016 at 12:01 PM Steve Ebersole <st...@hibernate.org> > >> wrote: > >> > >>> I went all the way back to 3.0. rsync started > >>> > >>> On Fri, Feb 12, 2016 at 11:44 AM Gunnar Morling <gun...@hibernate.org> > >>> wrote: > >>> > >>>> The more, the better. At least 4.3 is needed as it's the last BV 1.0 > >>>> compatible version. I don't exactly remember what we had there, but I > >>>> suppose all the way back till 3.0. So if you are at 4.2, you are > >>>> almost there :) > >>>> > >>>> 2016-02-12 18:31 GMT+01:00 Steve Ebersole <st...@hibernate.org>: > >>>>> so far I have downloaded back to 4.2. Should I stop at 5.0? > >>>>> > >>>>> > >>>>> On Fri, Feb 12, 2016 at 11:25 AM Gunnar Morling < > gun...@hibernate.org> > >>>>> wrote: > >>>>>> > >>>>>> Hey, > >>>>>> > >>>>>> That's weird indeed. Last time I checked (at the time of the HV > 5.2.3 > >>>>>> release), everything was still in place. > >>>>>> > >>>>>> http://hibernate.org/validator/documentation/ links to the > following: > >>>>>> > >>>>>> * > http://docs.jboss.org/hibernate/validator/5.3/reference/en-US/html/ > >>>>>> * > >>>> > http://docs.jboss.org/hibernate/validator/5.3/reference/en-US/html_single/ > >>>>>> * > >>>> > http://docs.jboss.org/hibernate/validator/5.3/reference/en-US/pdf/hibernate_validator_reference.pdf > >>>>>> * http://docs.jboss.org/hibernate/validator/5.3/api/ (JavaDoc) > >>>>>> > >>>>>> And the same for 5.2 and 4.3. Would be great to restore these ones > and > >>>>>> the "stable" alias at least; 5.1 and 5.0 would be bonus I suppose. > >>>>>> > >>>>>> Thanks, Steve, if you are taking this over. > >>>>>> > >>>>>> --Gunnar > >>>>>> > >>>>>> > >>>>>> > >>>>>> > >>>>>> > >>>>>> > >>>>>> > >>>>>> 2016-02-12 18:16 GMT+01:00 Davide D'Alto <dav...@hibernate.org>: > >>>>>>> Links seems to be in the format x.y > >>>>>>> At least looking at the links on > >>>>>>> http://hibernate.org/validator/documentation/ > >>>>>>> > >>>>>>> > >>>>>>> > >>>>>>> On Fri, Feb 12, 2016 at 5:08 PM, Steve Ebersole < > >>>> st...@hibernate.org> > >>>>>>> wrote: > >>>>>>> > >>>>>>>> What's the level of versions for the validator docs on the server? > >>>>>>>> x.y? > >>>>>>>> > >>>>>>>> On Fri, Feb 12, 2016 at 10:59 AM Steve Ebersole < > >>>> st...@hibernate.org> > >>>>>>>> wrote: > >>>>>>>> > >>>>>>>>> If the old style guides were there after the release, but gone > >>>> since > >>>>>>>>> I > >>>>>>>>> uploaded yesterday then maybe my upload also affected the > >>>> validator > >>>>>>>>> docs. > >>>>>>>>> No idea how that could have happened though. > >>>>>>>>> > >>>>>>>>> Anyway, I checked an the validator release bundles do in fact > >>>> contain > >>>>>>>>> the > >>>>>>>>> docs. I can work on restoring those. > >>>>>>>>> > >>>>>>>>> Sorry (if that really was me). > >>>>>>>>> > >>>>>>>>> On Fri, Feb 12, 2016 at 10:53 AM Steve Ebersole < > >>>> st...@hibernate.org> > >>>>>>>>> wrote: > >>>>>>>>> > >>>>>>>>>> But thats a completely different URL Vlad. That is a UR to the > >>>>>>>>>> hibernate.org server. Not the doc server. > >>>>>>>>>> > >>>>>>>>>> On Fri, Feb 12, 2016 at 10:48 AM Vlad Mihalcea > >>>>>>>>>> <mihalcea.v...@gmail.com > >>>>>>>>> > >>>>>>>>>> wrote: > >>>>>>>>>> > >>>>>>>>>>> The 5.1 docs are also missing too: > >>>>>>>>>>> > >>>>>>>>>>> http://hibernate.org/orm/documentation/5.1 > >>>>>>>>>>> > >>>>>>>>>>> I remember I saw the old-style guide right after the 5.1 > >>>> release. > >>>>>>>>>>> > >>>>>>>>>>> Vlad > >>>>>>>>>>> > >>>>>>>>>>> On Fri, Feb 12, 2016 at 6:44 PM, Steve Ebersole > >>>>>>>>>>> <st...@hibernate.org> > >>>>>>>>>>> wrote: > >>>>>>>>>>> > >>>>>>>>>>>> That's strange. As far as I know we actually cannot delete > >>>> from > >>>>>>>>>>>> there. At > >>>>>>>>>>>> least I was not allowed to delete from orm/5.1 yesterday when > >>>> I > >>>>>>>>>>>> was > >>>>>>>>>>>> doing > >>>>>>>>>>>> work. > >>>>>>>>>>>> > >>>>>>>>>>>> As for restoring, I do not know if backups are kept. We could > >>>>>>>>>>>> open a > >>>>>>>>>>>> ticket and see. If not, do y'all build docs into the release > >>>>>>>>>>>> bundles? > >>>>>>>>>>>> That could be an option > >>>>>>>>>>>> > >>>>>>>>>>>> On Fri, Feb 12, 2016 at 10:31 AM Emmanuel Bernard < > >>>>>>>>>>>> emman...@hibernate.org> > >>>>>>>>>>>> wrote: > >>>>>>>>>>>> > >>>>>>>>>>>>> Apparently http://docs.jboss.org/hibernate/validator is > >>>> gone > >>>>>>>>>>>>> from > >>>>>>>> the > >>>>>>>>>>>>> documentation server. Anyone has an idea of how that could > >>>> have > >>>>>>>>>>>>> happened? > >>>>>>>>>>>>> How to fix it would be very useful too, I'm not sure we > >>>> have a > >>>>>>>>>>>>> full > >>>>>>>>>>>>> backup of all the documentation since the history of time. > >>>>>>>>>>>>> > >>>>>>>>>>>>> Emmanuel > >>>>>>>>>>>>> _______________________________________________ > >>>>>>>>>>>>> hibernate-dev mailing list > >>>>>>>>>>>>> hibernate-dev@lists.jboss.org > >>>>>>>>>>>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev > >>>>>>>>>>>> _______________________________________________ > >>>>>>>>>>>> hibernate-dev mailing list > >>>>>>>>>>>> hibernate-dev@lists.jboss.org > >>>>>>>>>>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev > >>>>>>>> _______________________________________________ > >>>>>>>> hibernate-dev mailing list > >>>>>>>> hibernate-dev@lists.jboss.org > >>>>>>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev > >>>>>>> _______________________________________________ > >>>>>>> hibernate-dev mailing list > >>>>>>> hibernate-dev@lists.jboss.org > >>>>>>> https://lists.jboss.org/mailman/listinfo/hibernate-dev > > _______________________________________________ > > hibernate-dev mailing list > > hibernate-dev@lists.jboss.org > > https://lists.jboss.org/mailman/listinfo/hibernate-dev > _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev
