diff --git a/doc/source/decoder.rst b/doc/source/decoder.rst
index 3d07bb6fc6..178ba01c60 100644
--- a/doc/source/decoder.rst
+++ b/doc/source/decoder.rst
@@ -1,6 +1,6 @@
-=================
-OSC Mapping Table
-=================
+=============
+Mapping Guide
+=============
 
 The following is an incomplete mapping between legacy OpenStack CLIs and
 OpenStackClient. Think of it as a magic decoder ring if you were using the
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 2a87c9991b..e19b466b93 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -23,6 +23,10 @@ User Documentation
    interactive
    humaninterfaceguide
    backwards-incompatible
+
+.. toctree::
+   :maxdepth: 2
+
    decoder
 
 Getting Started