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
Is this what you were thinking of too?
Vlad
On Tue, Feb 16, 2016 at 8:54 PM, Emmanuel Bernard <emmanuel(a)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 <steve(a)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 <steve(a)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 <steve(a)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
<gunnar(a)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 <steve(a)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 <
gunnar(a)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/hiberna...
>>>>>> *
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
<davide(a)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 <
>>>> steve(a)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 <
>>>> steve(a)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
<
>>>> steve(a)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.vlad(a)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
>>>>>>>>>>> <steve(a)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 <
>>>>>>>>>>>> emmanuel(a)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(a)lists.jboss.org
>>>>>>>>>>>>>
https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>>>>>>>>>>>
_______________________________________________
>>>>>>>>>>>> hibernate-dev mailing list
>>>>>>>>>>>> hibernate-dev(a)lists.jboss.org
>>>>>>>>>>>>
https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>>>>>>> _______________________________________________
>>>>>>>> hibernate-dev mailing list
>>>>>>>> hibernate-dev(a)lists.jboss.org
>>>>>>>>
https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>>>>>> _______________________________________________
>>>>>>> hibernate-dev mailing list
>>>>>>> hibernate-dev(a)lists.jboss.org
>>>>>>>
https://lists.jboss.org/mailman/listinfo/hibernate-dev
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev(a)lists.jboss.org
>
https://lists.jboss.org/mailman/listinfo/hibernate-dev