diff --git a/Documentation/driver-api/index.rst b/Documentation/driver-api/index.rst
index 25f85d3021aa0cc63f568fb2c03595928c61551e..b5179bf2ada2be49efc155d1d69e79ddca8a2fa0 100644
--- a/Documentation/driver-api/index.rst
+++ b/Documentation/driver-api/index.rst
@@ -56,6 +56,7 @@ available subsections can be seen below.
    firmware/index
    pinctl
    gpio/index
+   md/index
    misc_devices
    nfc/index
    dmaengine/index
diff --git a/Documentation/md/index.rst b/Documentation/driver-api/md/index.rst
similarity index 89%
rename from Documentation/md/index.rst
rename to Documentation/driver-api/md/index.rst
index c4db34ed327ddff46ce0602defca1522ed247555..205080891a1a1e37cc274e2c45a3f737ce327b12 100644
--- a/Documentation/md/index.rst
+++ b/Documentation/driver-api/md/index.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 ====
 RAID
 ====
diff --git a/Documentation/md/md-cluster.rst b/Documentation/driver-api/md/md-cluster.rst
similarity index 100%
rename from Documentation/md/md-cluster.rst
rename to Documentation/driver-api/md/md-cluster.rst
diff --git a/Documentation/md/raid5-cache.rst b/Documentation/driver-api/md/raid5-cache.rst
similarity index 100%
rename from Documentation/md/raid5-cache.rst
rename to Documentation/driver-api/md/raid5-cache.rst
diff --git a/Documentation/md/raid5-ppl.rst b/Documentation/driver-api/md/raid5-ppl.rst
similarity index 100%
rename from Documentation/md/raid5-ppl.rst
rename to Documentation/driver-api/md/raid5-ppl.rst