diff --git a/doc/config-reference/block-storage/section_block-storage-sample-configuration-files.xml b/doc/config-reference/block-storage/section_block-storage-sample-configuration-files.xml
new file mode 100644
index 0000000000..53c321adc5
--- /dev/null
+++ b/doc/config-reference/block-storage/section_block-storage-sample-configuration-files.xml
@@ -0,0 +1,33 @@
+
+ Block Storage sample configuration files
+ All the files in this section can be found in /etc/cinder.
+
+ cinder.conf
+ Use the cinder.conf file to configure the
+ majority of the Block Storage service options.
+
+
+
+
+
+ api-paste.ini
+ Use the api-paste.ini file to configure the Block Storage API service.
+
+
+
+
+
+ policy.json
+ The policy.json file defines additional access controls that apply to the Block Storage service.
+
+
+
+ rootwrap.conf
+ The rootwrap.conf file defines configuration values used by the
+ rootwrap script when the Block Storage service must escalate its
+ privileges to those of the root user.
+
+
+
diff --git a/doc/config-reference/ch_blockstorageconfigure.xml b/doc/config-reference/ch_blockstorageconfigure.xml
index 39f67a85cf..0d9fb32d78 100644
--- a/doc/config-reference/ch_blockstorageconfigure.xml
+++ b/doc/config-reference/ch_blockstorageconfigure.xml
@@ -23,4 +23,5 @@
+