On 8 September 2017 at 14:46, Yoann Rodiere <yo...@hibernate.org> 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 consistent across them for people to not get confused. Minor nitpicking: the compatibility matrix isn't very visible when we have >=4 releases. > 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. > > Yoann Rodière > Hibernate NoORM Team > yo...@hibernate.org > > On 8 September 2017 at 15:11, Sanne Grinovero <sa...@hibernate.org> wrote: >> >> Thanks Yoann! >> Looks great. >> >> Two minor suggestions: >> - could the two links we have for each release on search/releases/ on >> two separate lines? Or something else to make it clear that there are >> two linkes. >> - Regarding the "Compatibility matrix", the header line (the one in >> black) .. I think we need to clarify in some way that you're referring >> to Hibernate Search releases. Possibly just link to the page >> describing the family? >> >> Thanks, >> Sanne >> >> >> On 8 September 2017 at 13:53, Yoann Rodiere <yo...@hibernate.org> wrote: >> > 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 constraints (ORM > 5.2, etc.) >> > The "Downloads" page is renamed to "Releases", since, well, it's about >> > more >> > than just downloads. See http://staging.hibernate.org/search/releases/ >> > The "Releases" page now includes a "Compatibilty matrix" section based >> > on >> > the new data I mentioned above >> > The "Releases" page now includes links to one page for each series >> > ("More on >> > the 5.8 series") >> > There is now one page for each series (see >> > http://staging.hibernate.org/search/releases/series/5.8/). This page >> > includes: >> > >> > A short (one-line) summary of this series >> > A reminder of the integration constraints for this series >> > A section about the main changes in this release. I only wrote something >> > for >> > the 5.8 series for now, and I basically copy/pasted sections from >> > various >> > blog posts. >> > A list of all releases in this series. >> > >> > What I didn't do, but could make sense: >> > >> > add a sub-menu element under "Releases" for each series >> > link to the documentation for each of the latest releases from the >> > "Releases" page >> > link to the latest documentation and to the migration guides from each >> > series' page >> > >> > What do you all think? Emmanuel, would this address your concerns? >> > Steve, >> > would this be a good fit for ORM? >> > >> > Yoann Rodière >> > Hibernate NoORM Team >> > yo...@hibernate.org >> > >> > On 6 September 2017 at 17:16, Steve Ebersole <st...@hibernate.org> >> > wrote: >> >> >> >> 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: >> >> >> >> https://github.com/hibernate/hibernate-orm/wiki/Roadmap5.2 >> >> https://github.com/hibernate/hibernate-orm/wiki/Migration-Guide---5.2 >> >> https://github.com/hibernate/hibernate-orm/wiki/ReleaseNotes5.2 >> >> >> >> >> >> The format could be better and some of this information could be >> >> combined >> >> (release notes and migration guide e.g.). But bear in mind that this >> >> was >> >> just what I put together to illustrate what I was wanted to do, >> >> generally >> >> speaking - so its a bit "rough" >> >> >> >> >> >> On Wed, Sep 6, 2017 at 4:17 AM Sanne Grinovero <sa...@hibernate.org> >> >> wrote: >> >>> >> >>> 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 roadmaps: I don't like to clutter the roadmap page with >> >>> the previous copies, especially as they should have a different nature >> >>> of not being a plan but being a record of what was actually done. >> >>> Also, we did agree in past meetings to remove all the old ones. e.g. >> >>> we never ported the release notes for version 3.x and 4.x as back then >> >>> we decided this was no place for that. Happy to revisit this decision >> >>> but let's separate them: >> >>> >> >>> What about a "past releases" page at the same level of roadmap, and >> >>> linking to it both from the main Search menu and the roadmap? >> >>> >> >>> +1 for Yoann's proposal to re-introduce the compatibility matrix >> >>> (there was one ~6 years ago). I also had proposed to reintroduce it >> >>> more recently, and was not done on the grounds that it gets out of >> >>> date quickly. >> >>> Still users badly need it so unless someone has a better idea, let's >> >>> agree on trying to keep it up to date manually. Let's try structure it >> >>> in such a way that it won't need to be updated for every single >> >>> release. >> >>> >> >>> Thanks, >> >>> Sanne >> >>> >> >>> >> >>> On 6 September 2017 at 08:37, Yoann Rodiere <yo...@hibernate.org> >> >>> wrote: >> >>> > 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 >> >>> > examples and so on. See for instance this blog post: >> >>> > http://in.relation.to/ >> >>> > 2017/06/13/hibernate-search-5-8-0-Beta3/ . I'm afraid the future >> >>> > roadmap >> >>> > would be drowned in the past releases. >> >>> > >> >>> > I was thinking about another problem: we don't have a compatibility >> >>> > matrix. >> >>> > We only have a few dependencies (mainly ORM and Lucene), but it's >> >>> > really >> >>> > hard to know which versions of the dependencies to use with which >> >>> > version >> >>> > of Search, and users frequently use the wrong versions. >> >>> > With that in mind, I would rather see a "Versions" page, with a >> >>> > summary >> >>> > at >> >>> > the top (including a one-liner for each minor and the compatibilty >> >>> > matrix), >> >>> > and one section for each minor (with anchors, so that we can link to >> >>> > them >> >>> > from other pages such as the downloads). Or maybe even one page for >> >>> > the >> >>> > detail of each minor, if there's too much text. >> >>> > I think it would make sense to have all that information gathered in >> >>> > a >> >>> > single place, because all of that is needed for users to pick the >> >>> > version >> >>> > they want: they need to know the benefits of upgrading (features) >> >>> > but >> >>> > also >> >>> > the constraints (compatibility matrix). >> >>> > Maybe I can give it a try at the end of the week? >> >>> > >> >>> > >> >>> > Yoann Rodière >> >>> > Hibernate NoORM Team >> >>> > yo...@hibernate.org >> >>> > >> >>> > On 6 September 2017 at 09:21, Emmanuel Bernard >> >>> > <emman...@hibernate.org> >> >>> > wrote: >> >>> > >> >>> >> 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/ >> >>> >> < >> >>> >> http://hibernate.org/search/downloads/> to read about the onliner >> >>> >> per >> >>> >> release. Except it’s a onliner per micro release and “minor >> >>> >> adjustments” >> >>> >> for 5.6.3.Final gave me literally no info whatsoever. >> >>> >> >> >>> >> My second reflex was to go to http://hibernate.org/search/roadmap/ >> >>> >> < >> >>> >> http://hibernate.org/search/roadmap/> to find a historical entry >> >>> >> about >> >>> >> older versions and the main changes in bullet points. No luck. It >> >>> >> only >> >>> >> talks about the future. >> >>> >> >> >>> >> My third reflex was to go to >> >>> >> http://in.relation.to/hibernate-search/ < >> >>> >> http://in.relation.to/hibernate-search/> I ended up giving up >> >>> >> midway >> >>> >> page >> >>> >> 2 of the list of blog entries. It’s a mix of simultaneous parallel >> >>> >> releases >> >>> >> with what’s new since the last CR or the last micro kind of reports >> >>> >> and >> >>> >> gave up in dismay at the energy I would have to spend to extract >> >>> >> what’s new >> >>> >> for a full minor release. >> >>> >> >> >>> >> I did exaggerate a bit the third point but I did give up. We need >> >>> >> somewhere a summary page of what’s new per minor releases. I think >> >>> >> the >> >>> >> roadmap page could be the host. >> >>> >> Likewise, we might need a oneliner entry in the download section >> >>> >> (per >> >>> >> release) that points to this minor release summary. >> >>> >> >> >>> >> Thoughts? >> >>> >> >> >>> >> Speaking of roadmap: >> >>> >> - HV roadmap is massively out of date >> >>> >> - OGM is lying a bit on the future but at least has the past >> >>> >> summary I >> >>> >> was >> >>> >> talking about >> >>> >> - Search has a good future roadmap but no past >> >>> >> >> >>> >> Emmanuek >> >>> >> _______________________________________________ >> >>> >> 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
