[hibernate-dev] Hibenrate-orm migration guides in one landing page

[Vlad Mihalcea]

Hi,

I've seen questions on our forum and SO related to migration from 3.x to
5.x,
and users are complaining that it's difficult to follow the migration
guides since they are scattered among hibernate.org and GitHub.

Emmanuel pointed out that in Hibernate Search we have a single migration
page:

http://hibernate.org/search/documentation/migrate/

I find this a very good idea, and I think we should follow the same trend.

So, I think we should have a new migration folder path under
hibernate-orm/documentation:

http://hibernate.org/orm/documentation/migrate/

The migration guides can still be written in Asciidoctor, as on GitHub, and
during release, we copy this folder to hibernate.org.

As for the hibernate.org landing page, we'll have to add a new link only
when we deploy a new version, which, even if we can't automate it, we can
do it after the release.

Let me know what you think?

Vlad