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

[Yoann Rodiere]

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