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

Btw, it's not à one line array, you also have he Java version. So maybe what's missing is a header to make it clearer? > Le 28 sept. 2017 à 16:33, Guillaume Smet a écrit : > >> On Thu, Sep 28, 2017 at 4:26 PM, Sanne Grinovero wrote: >> But I see

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

On Thu, Sep 28, 2017 at 4:26 PM, Sanne Grinovero wrote: > But I see how this can be far fetched, while there are objectinve > benefits from having a cleaner table, so feel free to remove it. > Well not really. I personally don't want to maintain specific templates for each

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

On 28 September 2017 at 14:53, Steve Ebersole wrote: > The question is not about whether to have that information. The question is > whether a one row table spanning horizontally across the screen is the best > presentation for that info. TBH I don't remember myself which

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

On Thu, Sep 28, 2017 at 3:53 PM, Steve Ebersole wrote: > The question is not about whether to have that information. The question > is whether a one row table spanning horizontally across the screen is the > best presentation for that info. > Yeah, the example of ORM is

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

The question is not about whether to have that information. The question is whether a one row table spanning horizontally across the screen is the best presentation for that info. On Thu, Sep 28, 2017 at 8:01 AM Sanne Grinovero wrote: > On 28 September 2017 at 13:30, Steve

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

On 28 September 2017 at 13:30, Steve Ebersole wrote: > Do y'all really think it makes sense to have JPA versions in this ORM > "compatibility matrix"? I think it's useful. Try booting a recent ORM version with an out of date JPA api jar: you'll get really weird exceptions

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

What's in the matrix is up to each project. You can remove content by editing the .yml file for each series, and removing elements from site.yml under projects.orm.integrations. I'd argue that moving away from the matrix for ORM just because Java compatibility is "not enough" will force us to add

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

Do y'all really think it makes sense to have JPA versions in this ORM "compatibility matrix"? My concern is that it is more involved (as we then try to convey in the section below that matrix) than a cell in a matrix/table with just a version number. If we end up treating JPA compatibility

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

On Thu, Sep 28, 2017 at 9:21 AM, Guillaume Smet wrote: > I was talking about the ability to access the old series when they are not > displayed in the overview. > > AFAICS, this is definitely missing and we would need either a page with > all the series linked from the

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

On 28 September 2017 at 08:21, Guillaume Smet wrote: > On Thu, Sep 28, 2017 at 9:00 AM, Yoann Rodiere wrote: >> >> > >> > > As a user, I still need to be able to go to a given series page to >> >> > understand what was done (see my initial use

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

On Thu, Sep 28, 2017 at 9:00 AM, Yoann Rodiere wrote: > > > > > As a user, I still need to be able to go to a given series page to > > > understand what was done (see my initial use case). But they can be in a > > > older series section in small vs big boxes. > > This is

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

> On 28 Sep 2017, at 09:00, Yoann Rodiere wrote: > > And yes, there's too much content in this section for Search 5.8, but that's > mainly because there's too much content in 5.8 to begin with. Ah, finally an objective measurement to force Sanne to release smaller but

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

> > > As a user, I still need to be able to go to a given series page to > understand what was done (see my initial use case). But they can be in a > > older series section in small vs big boxes. > This is currently missing. NO, it is not missing. At least, the concept is there. The "What's

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

On 26 September 2017 at 15:36, Emmanuel Bernard wrote: > All I wanted initially was to be able to get a description of what each > series provided so that when I jump from my version to the latest, I can > see what's going on. Then you guys wanted to expose the matrix of >

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

On Tue, Sep 26, 2017 at 4:36 PM, Emmanuel Bernard wrote: > As a user, I still need to be able to go to a given series page to > understand what was done (see my initial use case). But they can be in a > older series section in small vs big boxes. > This is currently

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

All I wanted initially was to be able to get a description of what each series provided so that when I jump from my version to the latest, I can see what's going on. Then you guys wanted to expose the matrix of compatibilities as e.g. people do consume Search with a given version of ORM. With

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

Aaaand it's merged. I tried to clean up release YAML files as much as possible for every project, adding missing files as necessary. You may want to add some content to each project, most notably to the "what's new" section of each series, but also to the compatibility matrix of each series. I

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

Thanks Yoann! Great work On 26 September 2017 at 14:10, Yoann Rodiere wrote: > Aaaand it's merged. > > I tried to clean up release YAML files as much as possible for every > project, adding missing files as necessary. > > You may want to add some content to each project,

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

Sorry for the confusion, my comment was indeed orthogonal and actually meant to get us all somwhat on the same page, as I have the feeling we have been proposing conflicting design changes (both here and in chat) because there is no agreement on the intent. I took that as a sign that our strategy

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

Hi Sanne, IMHO, this is an orthogonal discussion to the problem Yoann is trying to solve. Yoann didn't change anything about which versions are advertised. What I'm saying is that, if when we start a move, we have 4 other discussions about 4 other things we want to change, we won't do a move

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

And again I just wanted to say thanks, great job. It works much better I think, no matter these nit-picky things On Fri, Sep 22, 2017 at 11:00 AM Steve Ebersole wrote: > I think he is saying what I was saying... make the nav links point to the > latest version, but with

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

I think he is saying what I was saying... make the nav links point to the latest version, but with easy nav from there to list of all series/family/whatever On Fri, Sep 22, 2017 at 10:25 AM Yoann Rodiere wrote: > Ok, this will never end... It was good to merge less than

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

Ok, this will never end... It was good to merge less than 24h ago and now you're arguing against the very point of this work: provide users with more information regarding each series, so that they know what's new. (see the first email by Emmanuel) Please make concrete, exhaustive proposals. From

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

After some chats and a night of sleep on this, I think we need to stop obsessing about guiding people into the choice among multiple minor versions: it's hard enough that they have to pick a project. We need to encourage people to use the latest versions and we need to send a clear, strong

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

On Thu, Sep 21, 2017 at 6:45 PM, Sanne Grinovero wrote: > *IF* you are willing to improve a minor point: I didn't expect the > "Releases" menu to be expanded when not being in any of these > sections. > Let's keep that one for another time. > Related: I wouldn't highlight

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

I like it, looking forward to integration. *IF* you are willing to improve a minor point: I didn't expect the "Releases" menu to be expanded when not being in any of these sections. Related: I wouldn't highlight both the current release and the "Releases" label, the shading looks odd and

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

Looks like the issues I reported directly to you are fixed so it's OK for me. Emmanuel? On Thu, Sep 21, 2017 at 5:10 PM, Yoann Rodiere wrote: > No answer? So I guess I can merge it whenever I want? :-) > > Yoann Rodière > Hibernate NoORM Team > yo...@hibernate.org >

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

No answer? So I guess I can merge it whenever I want? :-) Yoann Rodière Hibernate NoORM Team yo...@hibernate.org On 19 September 2017 at 08:36, Yoann Rodiere wrote: > So, following the comments and a discussion on Hangouts on Friday, I > worked a bit more, and I just

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

So, following the comments and a discussion on Hangouts on Friday, I worked a bit more, and I just pushed what will hopefully be the last version ;) Main changes: - The "Releases" menu entry now has one sub-entry for each series - The big, green/yellow buttons related to the

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

On 14 September 2017 at 13:34, Steve Ebersole wrote: > Yoann, > > First thanks for the work on this. I think it looks worlds better. A few > minor things: > > Not sure of the source for this, but can we fix these doc link for 5.2 from >

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

On Thu, Sep 14, 2017 at 9:03 PM, Emmanuel Bernard wrote: > I don’t like it. It’s less important than what the various versions bring > (the onliner) and the ability to go download them right away. > OK. Let's agree to disagree :). We often have SO questions of people not

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

I don’t like it. It’s less important than what the various versions bring (the onliner) and the ability to go download them right away. > On 14 Sep 2017, at 15:27, Guillaume Smet wrote: > > Hi, > > Would anyone have something about putting the Compatibility matrix

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

This makes me a little nervous in the case we ever publish other manuals/docs. IMO the better option is to publish an index.html that is currently just a redirect to the User Manual On Thu, Sep 14, 2017, 7:55 AM Vlad Mihalcea wrote: > Hi, > > To be able to load the

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

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

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

Hi, To be able to load the User Guide like this: https://docs.jboss.org/hibernate/orm/5.2 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

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

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

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

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,

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

On Wed 17-09-13 10:55, Sanne Grinovero wrote: >On 13 September 2017 at 10:51, Yoann Rodiere 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.

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

On 13 September 2017 at 10:51, Yoann Rodiere 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

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

> > 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

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

On Tue 17-09-12 13:50, Yoann Rodiere wrote: >> >> - Releases speaks less than downloads, Where do I download Hibernate X >> is a question we want addressed from the top level menus >> > >Always amazed that there's still people out there actually downloading JARs >manually. But yes, we shouldn't

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

On 13 September 2017 at 10:41, Emmanuel Bernard wrote: > On Tue 17-09-12 13:50, Yoann Rodiere wrote: >>> >>> >>> - Releases speaks less than downloads, Where do I download Hibernate X >>> is a question we want addressed from the top level menus >>> >> >> Always amazed

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

> > - Releases speaks less than downloads, Where do I download Hibernate X > is a question we want addressed from the top level menus > Always amazed that there's still people out there actually downloading JARs manually. But yes, we shouldn't forget about them. My problem with "downloads" is

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

Hey Yoann and all, Thanks Yoann for stepping up. This is definitely much better. Here are non ordered comments: - Releases speaks less than downloads, Where do I download Hibernate X is a question we want addressed from the top level menus - if you do downloads -> releases, you need to also

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

On 8 September 2017 at 14:46, Yoann Rodiere wrote: > Sanne, I addressed both your comments. Is it better? I love it, definitely a step forward! But we'll need to find some compromise with the requirements of the other projects - e.g. Steve's feedback - : it should be

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

Following Steve's comments, I made another few changes for the sake of usability: - Moved the series-specific pages so that the path is more consistent with ORM documentation; the series-specific page for Search 5.8, for instance, is now http://staging.hibernate.org/search/releases/5.8/

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

On Fri, Sep 8, 2017 at 9:45 AM Yoann Rodiere wrote: > Steve, > > If I understood correctly, the main difference between what I did and what > you want is you don't want a "hub" pointing to different versions, you want > to redirect to the page for the latest version, and

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

Steve, If I understood correctly, the main difference between what I did and what you want is you don't want a "hub" pointing to different versions, you want to redirect to the page for the latest version, and from there allow to move to another version using drop-down. While I can understand

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

For me the real problem is that its not just Downloads/Releases that should be (need to be really) treated in this manner - our documentation is also family specific. So for ORM I had envisioned a "versions" (although "releases" works just as well) component to the url scheme. Vlad did this for

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

Sanne, I addressed both your comments. Is it better? I also addressed Guillaume's comment on HipChat, and made the compatibility matrix a bit... fuzzier, so that we won't have to update it as often. We can still make it very specific if we want to, but we won't be limited by the layout anymore.

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

Hey, I pushed an update to staging. I only converted the "Search" part for now. What changes: - The _data folder structured changed a bit, so that we can introduces a YAML file for each series (5.5, 5.6, 5.6, 5.8, ...), containing a summary of this series and a list of integration

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

This is something I brought up ages ago wrt ORM. I wanted something (although ideally integrated with the "more version friendly" hibernate.org design) similar to what I did atm on the ORM GitHub wiki. For example, for 5.2 we have: -

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

Thanks for that Emmanuel. I'll fix the one-liner describing the release, I believe we had already noticed this in the past: they need to describe the whole minor not the micro update. The Search roadmap actually also needs a little re-touch, I'll propose a PR for that too. Regarding past

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

@Marko, Yes, I plan to review them this week and add additional things to it! On Wed, Sep 6, 2017 at 9:55 AM, Marko Bekhta wrote: > Hi Emmanuel, > > I did some updates to HV roadmap with this PR [1]. There's also some > updates to > HV contribute page. Maybe somebody

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

Hi Emmanuel, I did some updates to HV roadmap with this PR [1]. There's also some updates to HV contribute page. Maybe somebody could check those changes and if needed add more to what is present, if what is already there is fine. Have a nice day, Marko [1]

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

Hey, About Search, true, the information is somewhat hidden in many blog posts. I'm not sure the roadmap is the right place, though, since we probably want the format to be different for past and future releases: information for past releases is typically more precise and more verbose, with code

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

Hey all, I was trying to answer the following question, what is roughly new between 5.6, 5.7 and 5.8 (minor releases)? My first reflex was to go to http://hibernate.org/search/downloads/ to read about the onliner per release. Except it’s a onliner per