Re: [hibernate-dev] [Search and more] What is new in a give release

On 14 Sep 2017, at 15:27, Guillaume Smet <guillaume.smet(a)gmail.com&gt; wrote: Hi, Would anyone have something about putting the Compatibility matrix before the Series part in the page: http://staging.hibernate.org/ogm/releases/ ? Atm, we don't see the matrix at a quick glance (I totally missed it until Yoann told me it was there) and I think it's probably the first information you need when you want to download something. Typically, if you're stuck to Java 6 for whatever reasons, no need to take a look at the 5.2 serie. It's maybe a little less sexy but it would be more useful IMHO. -- Guillaume On Thu, Sep 14, 2017 at 2:55 PM, Vlad Mihalcea <mihalcea.vlad(a)gmail.com&gt; wrote: > Hi, > > To be able to load the User Guide like this: > > https://docs.jboss.org/hibernate/orm/5.2 > <https://docs.jboss.org/hibernate/orm/5.2%60> > > we have two options: > > 1. Either we rename the User Guide to index.adoc so that it will become > index.html. > 2. We leave it as-is, but when we copy the docs to JBoss, we also copy the > User Guide as index.html as well. This will allow our users to retain > bookmarks they've created since we published the new User Guide. > > Let me know which one do you prefer. > Vlad > > On Thu, Sep 14, 2017 at 3:34 PM, Steve Ebersole <steve(a)hibernate.org&gt; > wrote: > >> Yoann, >> >> First thanks for the work on this. I think it looks worlds better. A > few >> minor things: >> >> >> 1. Not sure of the source for this, but can we fix these doc link for >> 5.2 from ` >> https://docs.jboss.org/hibernate/stable/orm/userguide/html_single/ >> Hibernate_User_Guide.html` >> to `https://docs.jboss.org/hibernate/orm/5.2`? Also, why https? Not >> sure it matters, just found it odd >> 2. Much of the information on that ORM releases page is, in turn, >> version/series specific. Any reason why those pieces of information > are >> not part of the series? Either in the synopsis on the releases page > or >> on >> the specific series page, or both. Specifically >> 1. "Compatibility Matrix" - the fact that its a table based on > series >> is a good indicator it is all series specific ;) >> 2. "Maven Repository" - I'd personally prefer to have this as part > of >> the series info >> 3. I think the individual series pages are missing a key piece of >> information... the "synopsis" of that series. I guess partially this >> fits >> under "what's new" >> >> Other than these minor things I love it. Great job! >> >> P.S. another question is whether (and if so, how) to apply the same >> treatment to the Documentation info in terms of the nav links. >> >> On Thu, Sep 14, 2017 at 7:05 AM Yoann Rodiere <yoann(a)hibernate.org&gt; > wrote: >> >>> I polished the changes, applied them to all projects (ORM, OGM, >> Validator, >>> Search), and sent a PR: >>> https://github.com/hibernate/hibernate.org/pull/126 >>> Could you guys review it? Mainly I'd need one person per project to > check >>> they agree with the changes, especially in their project's section. >>> Also, there's still a bit of work to do for each project, mainly > filling >>> in missing metadata (see the PR). >>> >>> Yoann Rodière >>> Hibernate NoORM Team >>> yoann(a)hibernate.org >>> >>> On 14 September 2017 at 10:38, Emmanuel Bernard < > emmanuel(a)hibernate.org&gt; >>> wrote: >>> >>>> On Wed 17-09-13 10:55, Sanne Grinovero wrote: >>>> >>>>> On 13 September 2017 at 10:51, Yoann Rodiere <yoann(a)hibernate.org&gt; >>>>> wrote: >>>>> >>>>>> It's more the number of columns, what if you add more version, > should >> I >>>>>>> scroll horizontally? Also releeases tend to be shown vertically > with >>>>>>> version in desc order. This model breaks a bit this habit. >>>>>>> >>>>>> >>>>>> >>>>>> At least versions are in desc order :D >>>>>> More seriously, I was more worried about the number of dependencies >> than >>>>>> about the number of series. We don't want to maintain a hundred >>>>>> branches, so >>>>>> we'll probably try to keep the number of series to a minimum, but we >> do >>>>>> want >>>>>> to offer as much as possible to users, so we may offer many > different >>>>>> integrations, and thus many different dependencies. Just think if > the >>>>>> ORM >>>>>> team wants to display supported versions of each DBMS... So I > thought >>>>>> showing versions horizontally would be more future-proof. >>>>>> I'll try to add horizontal scrolling to the table. The oldest > releases >>>>>> may >>>>>> not be displayed, but then those are not the one we want to > advertise, >>>>>> so... >>>>>> And in any case, we have limited horizontal space, so we have to > hide >>>>>> *something*. >>>>>> About phones, I think bootstrap has something, I'll give it a try. >>>>>> >>>>>> On "Downloads" we only want to promote the active branches; have > some >>>>>>> basic series descriptions but way more ecclectic than the releases >>>>>>> descriptions. We make them cross-linked and everyone is happy? >>>>>>> >>>>>> >>>>>> >>>>>> Sure, we can do that. But the "downloads" page will essentially be a >>>>>> stripped-down version of the "releases" page. >>>>>> >>>>> >>>>> +1 since maintenance is automated I see no problem with a little >>>>> redundancy. >>>>> >>>> >>>> I'm not sure two pages is really solving the problem. It looks like > you >>>> don't want to make a choice. But I don't have a pro/con opinion. >>>> My real concern is since you will have two pages, what's the > navigation >>>> logic? How do you reach each on of these pages? >>>> >>>> Just thinking out loud here but I think the one way to solve long >>>> standing Steve objective is indeed to have per series sections of the >>>> website (including download, documentation, migration guide) >>>> And a top nav for "latest/promoted" releases (like we have today >>>> really). >>>> How do you merge the two navigation wise is what I don't know. >>>> This is for later work anyways. >>>> >>> >>> >> _______________________________________________ >> 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