diff --git a/doc/source/sample_config.rst b/doc/source/configuration/sample-config.rst
similarity index 70%
rename from doc/source/sample_config.rst
rename to doc/source/configuration/sample-config.rst
index ae8e6f17bf26..54b1bd1fdb7d 100644
--- a/doc/source/sample_config.rst
+++ b/doc/source/configuration/sample-config.rst
@@ -7,6 +7,7 @@ auto-generated from Nova when this documentation is built, so
 if you are having issues with an option, please compare your version of
 Nova with the version of this documentation.
 
-The sample configuration can also be viewed in `file form <_static/nova.conf.sample>`_.
+The sample configuration can also be viewed in :download:`file form
+</_static/nova.conf.sample>`.
 
-.. literalinclude:: _static/nova.conf.sample
+.. literalinclude:: /_static/nova.conf.sample
diff --git a/doc/source/sample_policy.rst b/doc/source/configuration/sample-policy.rst
similarity index 61%
rename from doc/source/sample_policy.rst
rename to doc/source/configuration/sample-policy.rst
index dba4d27abcb1..acf67dfb626b 100644
--- a/doc/source/sample_policy.rst
+++ b/doc/source/configuration/sample-policy.rst
@@ -6,7 +6,7 @@ The following is a sample nova policy file, autogenerated from nova when this
 documentation is built. To prevent conflicts, ensure your version of nova
 aligns with the version of this documentation.
 
-The sample policy can also be viewed in `file form
-<_static/nova.policy.yaml.sample>`_.
+The sample policy can also be viewed in :download:`file form
+</_static/nova.policy.yaml.sample>`.
 
-.. literalinclude:: _static/nova.policy.yaml.sample
+.. literalinclude:: /_static/nova.policy.yaml.sample
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 4dcd5466e4d4..1327dee5ca6a 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -199,7 +199,7 @@ Sample Configuration File
 .. toctree::
     :maxdepth: 1
 
-    sample_config
+    configuration/sample-config
 
 Sample Policy file
 ------------------
@@ -207,7 +207,7 @@ Sample Policy file
 .. toctree::
     :maxdepth: 1
 
-    sample_policy
+    configuration/sample-policy
 
 Man Pages
 ----------