Add migration guide

docs/3.x.x/migration-guide/README.md

@@ -30,3 +30,4 @@
 - [Migration guide from alpha.21 to alpha.22](migration-guide-alpha.21-to-alpha.22.md)
 - [Migration guide from alpha.22 to alpha.23](migration-guide-alpha.22-to-alpha.23.md)
 - [Migration guide from alpha.23 to alpha.24](migration-guide-alpha.23-to-alpha.24.md)
+- [Migration guide from alpha.24 to alpha.25](migration-guide-alpha.24-to-alpha.25.md)

docs/3.x.x/migration-guide/migration-guide-alpha.24-to-alpha.25.md

@@ -0,0 +1,69 @@
+# Migration guide from alpha.24 to alpha.25
+
+**Here are the major changes:**
+
+- Getting started videos helper in the admin
+- New getting started
+
+**Useful links:**
+- Changelog: [https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.25](https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.25)
+- GitHub diff: [https://github.com/strapi/strapi/compare/v3.0.0-alpha.23...v3.0.0-alpha.25](https://github.com/strapi/strapi/compare/v3.0.0-alpha.23...v3.0.0-alpha.25)
+
+<br>
+
+::: note
+Feel free to [join us on Slack](http://slack.strapi.io) and ask questions about the migration process.
+:::
+
+<br>
+
+## Getting started
+
+Install Strapi `alpha.25` globally on your computer. To do so run `npm install strapi@3.0.0-alpha.25 -g`.
+
+When it's done, generate a new empty project `strapi new myNewProject` (don't pay attention to the database configuration).
+
+<br>
+
+## Update node modules
+
+Update the Strapi's dependencies version (move Strapi's dependencies to `3.0.0-alpha.25` version) of your project.
+
+Run `npm install strapi@3.0.0-alpha.25 --save` to update your strapi version.
+
+<br>
+
+## Update the Admin
+
+::: note
+If you performed updates in the Admin, you will have to manually migrate your changes.
+:::
+
+Delete your old admin folder and replace it with the new one.
+
+<br>
+
+## Update the Plugins
+
+::: note
+If you did a custom update on one of the plugins, you will have to manually migrate your update.
+:::
+
+Copy the fields and relations you had in your `/plugins/users-permissions/models/User.settings.json` and `/plugins/users-permissions/config/jwt.json` file in the new one.
+
+Then, delete your old `plugins` folder and replace it with the new one.
+
+## Update Mongoose
+
+Update all your API services by following this update https://github.com/strapi/strapi/pull/2812/files#diff-c36b911d1bc2922e1d7cf93ae692e054R132
+
+## Update Bookshelf
+
+Update all your API services by following this update https://github.com/strapi/strapi/pull/2970/files#diff-61ba361ed6161efcd5f4e583001cc9c9R240 and  https://github.com/strapi/strapi/pull/2864/files#diff-61ba361ed6161efcd5f4e583001cc9c9R124
+
+We update the name of the life cycle for the before/after fetch all https://github.com/strapi/strapi/pull/2965/files
+You will have to replace `beforeFetchCollection` by `beforeFetchAll` if you added theses functions in you `Model.js` files.
+
+<br>
+
+That's all, you have now upgraded to Strapi `alpha.25`.