diff --git a/doc/source/conf.py b/doc/source/conf.py
index d055d1e1..05991671 100755
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -22,8 +22,8 @@ sys.path.insert(0, os.path.abspath('../..'))
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
     'sphinx.ext.autodoc',
-    #'sphinx.ext.intersphinx',
-    'oslosphinx'
+    'oslosphinx',
+    'oslo_config.sphinxext',
 ]
 
 # autodoc generation is a bit aggressive and a nuisance when doing heavy
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 41e7b908..8fe606a0 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -13,6 +13,7 @@ Contents
    installation
    api/modules
    usage
+   opts
    contributing
    history
 
diff --git a/doc/source/opts.rst b/doc/source/opts.rst
new file mode 100644
index 00000000..0827952d
--- /dev/null
+++ b/doc/source/opts.rst
@@ -0,0 +1,8 @@
+=======================
+ Configuration Options
+=======================
+
+oslo.cache uses oslo.config to define and manage configuration options
+to allow the deployer to control how an application uses this library.
+
+.. show-options:: oslo.cache