3 files changed, 20 insertions, 5 deletions
diff --git a/docs/tutorials/cmf/actions.rst b/docs/tutorials/cmf/actions.rst
index 7e66f3236..3703db770 100644
--- a/docs/tutorials/cmf/actions.rst
+++ b/docs/tutorials/cmf/actions.rst
@@ -17,9 +17,10 @@ which has keys that are action names, and values which are tuples of
 have some passable actions tool replacement within a single application.
 
 The `repoze.bfg.viewgroup
-<http://svn.repoze.org/repoze.bfg.viewgroup/trunk/>` package provides
+<http://svn.repoze.org/repoze.bfg.viewgroup/trunk/>`_ package provides
 some functionality for creating "view groups".  Each view in a
 viewgroup can provide some snippet of HTML (e.g. a single "tab"), and
-views (tabs) which cannot be displayed to the user due to the user's
-lack of permissions will be omitted from the group.
+individual views (tabs) within the group which cannot be displayed to
+the user due to the user's lack of permissions will be omitted from
+the rendered output.
 
diff --git a/docs/tutorials/cmf/index.rst b/docs/tutorials/cmf/index.rst
index 09223138c..9b1168be9 100644
--- a/docs/tutorials/cmf/index.rst
+++ b/docs/tutorials/cmf/index.rst
@@ -25,11 +25,10 @@ because CMF happens to provide other helpful services, such as types,
 skins, and workflow; this tutorial is for those sorts of developers
 and projects.
 
-Missing:
+XXX Missing:
 
    templates.rst
    forms.rst
-   workflow.rst
    membership.rst
    discussions.rst
    syndication.rst
@@ -42,5 +41,6 @@ Missing:
    catalog.rst
    skins.rst
    actions.rst
+   workflow.rst
 
 
diff --git a/docs/tutorials/cmf/workflow.rst b/docs/tutorials/cmf/workflow.rst
new file mode 100644
index 000000000..251ce3fc4
--- /dev/null
+++ b/docs/tutorials/cmf/workflow.rst
@@ -0,0 +1,14 @@
+.. _workflow_chapter:
+
+========
+Workflow
+========
+
+In CMF, the "workflow tool" allows developers to design state machines
+which imply transition between content states.
+
+:mod:`repoze.bfg` itself has no such concept, but the
+:term:`repoze.lemonade` packge provides a simple persistent state
+machine implementation that can act as a barebones workflow tool.  See
+its documentation for more information.
+