The Wiki has the full migration guide, including all steps to get to 5.0, at high detail.

We decided to also have a "migrate to 5.0 guide" on the website because the migration from 3.x and 4.x to 5.0 is a big deal, but we never thought of having all of the migration guide on the website.

I see two alternatives:

Option A

• we add a landing page at http://hibernate.org/search/documentation/migrate/ which refers to the wiki and to the 5.0 migration
• we add a link from the 5.0 migration to the wiki too

Option B

• we break up the migration wiki in pages similar to the "migrate to 5.0" guide, probably by major version
• we add the landing page as an high level index and general introduction, to point to each sub guide

My preference would be to implement A right now, and then see if we can make time for the second one, if we want to move away from the jive wiki generally speaking.