[hibernate-dev] ORM - Migration guides: wiki or source repository?

[Guillaume Smet]

Hi,

I see that we have a migration-guide.adoc document in the repository:
https://github.com/hibernate/hibernate-orm/blob/master/migration-guide.adoc

and we also have migration guides in the wiki:
https://github.com/hibernate/hibernate-orm/wiki/Migration-Guide---5.2
https://github.com/hibernate/hibernate-orm/wiki/Migration-Guide---5.3

Is there a reason why we have both?

Lately, I updated the wiki one and I just noticed Gail updated the source
one. So if we keep both, we will need to keep them in sync but I'm not sure
there's any value in keeping both. Except having a migration guide bundled
in the zip archive, maybe?

Thoughts?

Thanks!

-- 
Guillaume