diff --git a/doc/source/examples.rst b/doc/source/examples.rst
new file mode 100644
index 00000000..c6d2e3ed
--- /dev/null
+++ b/doc/source/examples.rst
@@ -0,0 +1,11 @@
+========
+Examples
+========
+
+While developing TaskFlow the team has worked hard to make sure the concepts
+that TaskFlow provides are explained by *relevant* examples. To explore these
+please check out the `examples`_ directory in the TaskFlow source tree. If the
+examples provided are not satisfactory (or up to your standards) contributions
+are welcome and very much appreciated to improve them.
+
+.. _examples: http://git.openstack.org/cgit/openstack/taskflow/tree/taskflow/examples
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 387980e4..dbd83c4b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -27,6 +27,7 @@ Contents
    exceptions
    utils
    states
+   examples
 
 Indices and tables
 ==================