diff --git a/doc/source/guides/dashboard_guide.rst b/doc/source/guides/dashboard_guide.rst
index af7489efe..434c97eff 100644
--- a/doc/source/guides/dashboard_guide.rst
+++ b/doc/source/guides/dashboard_guide.rst
@@ -1,3 +1,4 @@
+====================================
 Mistral Dashboard Installation Guide
 ====================================
 
@@ -5,7 +6,7 @@ Mistral dashboard is the plugin for Horizon where it is easily possible to contr
 mistral objects by interacting with web user interface.
 
 Setup Instructions
-==================
+------------------
 This instruction assumes that Horizon is already installed and it's installation
 folder is <horizon>. Detailed information on how to install Horizon can be
 found at `Horizon Installation <http://docs.openstack.org/developer/horizon/quickstart.html#setup.>`_
@@ -50,7 +51,8 @@ The following should get you started:
     $ tox -evenv -- python manage.py runserver
 
 Debug Instructions
-==================
+------------------
+
 **Pycharm**
 
 Set PyCharm debug settings:
diff --git a/doc/source/guides/writing_workflow.rst b/doc/source/guides/writing_workflow.rst
deleted file mode 100644
index 0658adb2b..000000000
--- a/doc/source/guides/writing_workflow.rst
+++ /dev/null
@@ -1,4 +0,0 @@
-How To Write Workflow
-=====================
-
-TBD
\ No newline at end of file
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 867f08f5b..3b03f14e3 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -31,7 +31,6 @@ User guide
    guides/dashboard_guide
    guides/upgrade_guide
    guides/mistralclient_guide
-   guides/writing_workflow
 
 **API**
 
diff --git a/doc/source/quickstart.rst b/doc/source/quickstart.rst
index 44266ef00..091e0b57e 100644
--- a/doc/source/quickstart.rst
+++ b/doc/source/quickstart.rst
@@ -24,8 +24,6 @@ To use the OpenStack command line tools you should specify environment variables
 Write Workflow
 --------------
 
-* Refer to the tutorial :doc:`How To Write a Workflow </guides/writing_workflow>`
-
 For example, the following workflow has been written::
 
     ---