diff --git a/doc/config-reference/block-storage/drivers/datera-volume-driver.xml b/doc/config-reference/block-storage/drivers/datera-volume-driver.xml
new file mode 100644
index 0000000000..9f9f5796dd
--- /dev/null
+++ b/doc/config-reference/block-storage/drivers/datera-volume-driver.xml
@@ -0,0 +1,21 @@
+
+
+ Datera volume driver
+
+
+
+ Set the following in your cinder.conf to
+ use the Datera volume driver:
+
+ volume_driver = cinder.volume.drivers.datera.DateraDriver
+
+ Use the following options to configure the volume driver:
+
+
+
diff --git a/doc/config-reference/block-storage/drivers/fusionio-volume-driver.xml b/doc/config-reference/block-storage/drivers/fusionio-volume-driver.xml
new file mode 100644
index 0000000000..21bd0c942d
--- /dev/null
+++ b/doc/config-reference/block-storage/drivers/fusionio-volume-driver.xml
@@ -0,0 +1,22 @@
+
+
+ FusionIO volume driver for the ioControl Hybrid storage subsystem
+
+
+
+
+ Set the following in your cinder.conf to
+ use the FusionIO volume driver:
+
+ volume_driver = cinder.volume.drivers.fio_ioControl.fio_ioControl
+
+ Use the following options to configure the volume driver:
+
+
+
diff --git a/doc/config-reference/block-storage/drivers/nimble-volume-driver.xml b/doc/config-reference/block-storage/drivers/nimble-volume-driver.xml
new file mode 100644
index 0000000000..b352c4af17
--- /dev/null
+++ b/doc/config-reference/block-storage/drivers/nimble-volume-driver.xml
@@ -0,0 +1,22 @@
+
+
+ Nimble volume driver
+
+
+
+
+ Set the following in your cinder.conf to
+ use the Nimble volume driver:
+
+ volume_driver = cinder.volume.drivers.nimble.NimbleISCSIDriver
+
+ Use the following options to configure the volume driver:
+
+
+
diff --git a/doc/config-reference/block-storage/section_misc.xml b/doc/config-reference/block-storage/section_misc.xml
index 2f172ef3bf..c745af7224 100644
--- a/doc/config-reference/block-storage/section_misc.xml
+++ b/doc/config-reference/block-storage/section_misc.xml
@@ -15,7 +15,6 @@
-
@@ -48,9 +47,7 @@
-
-
diff --git a/doc/config-reference/block-storage/section_volume-drivers.xml b/doc/config-reference/block-storage/section_volume-drivers.xml
index 9eb5dde59c..1be7e2d279 100644
--- a/doc/config-reference/block-storage/section_volume-drivers.xml
+++ b/doc/config-reference/block-storage/section_volume-drivers.xml
@@ -23,6 +23,7 @@
+
@@ -37,6 +38,7 @@
+