diff --git a/doc/source/devref/index.rst b/doc/source/devref/index.rst
index a8ad24861fe..4357e250b45 100644
--- a/doc/source/devref/index.rst
+++ b/doc/source/devref/index.rst
@@ -49,6 +49,7 @@ Background Concepts for Cinder
 
    architecture
    attach_detach_conventions
+   attach_detach_conventions_v2
    threading
    i18n
    rpc
diff --git a/doc/source/index.rst b/doc/source/index.rst
index d7bd6101ecf..84202b4987c 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -41,10 +41,8 @@ Developer Docs
    :maxdepth: 1
 
    devref/index
-   database_architecture
    scheduler-filters
    scheduler-weights
-   oslo-middleware
    upgrade
 
 Drivers