toc reshuffle

Author: rustagir

docs/index.txt

@@ -14,8 +14,9 @@
    :maxdepth: 1
 
    /quick-start
-   /usage-examples
    Release Notes <https://github.com/mongodb/laravel-mongodb/releases/>
+   /upgrade
+   /usage-examples
    /fundamentals
    /eloquent-models
    /query-builder
@@ -27,7 +28,6 @@
    /issues-and-help
    /feature-compatibility
    /compatibility
-   /upgrade
 
 Introduction
 ------------
@@ -52,6 +52,17 @@ Learn how to add the {+odm-short+} to a Laravel web application, connect to
 MongoDB hosted on MongoDB Atlas, and begin working with data in the
 :ref:`laravel-quick-start` section.
 
+Upgrade Versions
+----------------
+
+.. important::
+
+   {+odm-long+} v5.0 introduces breaking changes that might affect how you
+   upgrade your application from a v4.x version.
+
+Learn what changes you must make to your application to upgrade between
+major versions in the :ref:`laravel-upgrading` section.
+
 Usage Examples
 --------------
 
@@ -94,10 +105,3 @@ Compatibility
 
 To learn more about which versions of {+odm-long+} and Laravel are
 compatible, see the :ref:`laravel-compatibility` section.
-
-Upgrade Versions
-----------------
-
-Learn what changes you must make to your application to upgrade versions in
-the :ref:`laravel-upgrading` section.
-