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

Emmanuel Bernard emmanuel at hibernate.org
Wed Jun 29 09:48:51 EDT 2016


+1

> On 29 Jun 2016, at 10:14, Vlad Mihalcea <mihalcea.vlad at gmail.com> wrote:
> 
> 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
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev



More information about the hibernate-dev mailing list