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

[Steve Ebersole]

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 <sanne at 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 <yoann at 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
> > yoann at hibernate.org
> >
> > On 6 September 2017 at 09:21, Emmanuel Bernard <emmanuel at 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 at lists.jboss.org
> >> https://lists.jboss.org/mailman/listinfo/hibernate-dev
> > _______________________________________________
> > hibernate-dev mailing list
> > hibernate-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/hibernate-dev
>
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev