On 29 Jun 2016, at 10:14, Vlad Mihalcea <mihalcea.vlad(a)gmail.com&gt; 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(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev