diff --git a/docs/index.rst b/docs/index.rst
index 9354be97a..34002786f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -19,6 +19,15 @@ API Reference
   types
   admin_client
 
+Migration Guide
+---------------
+
+See the guide below for instructions on migrating to the 2.x release of this library.
+
+.. toctree::
+    :maxdepth: 2
+
+    UPGRADING
 
 Changelog
 ---------