diff --git a/docs/src/index.rst b/docs/src/index.rst
index 165816d5e..d89f251fd 100644
--- a/docs/src/index.rst
+++ b/docs/src/index.rst
@@ -45,6 +45,7 @@ Documentation
 
    design
    api
+   upgrading
 
 
 Downloads
@@ -58,13 +59,3 @@ Installation
 
 Installation instructions can be found in `the README <https://github.com/libuv/libuv/blob/master/README.md>`_.
 
-
-Upgrading
----------
-
-Migration guides for different libuv versions, starting with 1.0.
-
-.. toctree::
-   :maxdepth: 1
-
-   migration_010_100
diff --git a/docs/src/upgrading.rst b/docs/src/upgrading.rst
new file mode 100644
index 000000000..32840c269
--- /dev/null
+++ b/docs/src/upgrading.rst
@@ -0,0 +1,11 @@
+.. _upgrading:
+
+Upgrading
+=========
+
+Migration guides for different libuv versions, starting with 1.0.
+
+.. toctree::
+   :maxdepth: 1
+
+   migration_010_100