diff --git a/docs/basics.rst b/docs/basics.rst
index 42a4f1543e32a1c08ce5583dbbba2e7d01a3820b..a5a1a59e76acc9a027b6477e31f37feacfaed559 100644
--- a/docs/basics.rst
+++ b/docs/basics.rst
@@ -45,9 +45,10 @@ subdivisions. The firetasks of one firework
     - are executed strictly one after another in the order of their specification;
     - share the same job working directory and the files in it.
 
-Here is a short example of a workflow, demonstration the use of the 
+Here is a short example for a workflow demonstrating the usage of the 
 ``PythonFunctionTask``::
 
+    fws:
     - fw_id: 1
       name: Grind coffee
       spec:
@@ -72,7 +73,10 @@ Here is a short example of a workflow, demonstration the use of the
     name: Simple coffee workflow
 
 Open a text editor, such as ``vi``, ``nano``, ``gedit`` or ``emacs``, and save the 
-example above as **workflow.yaml**.
+example above as **workflow.yaml**. To convert to JSON you can use the following
+command::
+
+    yaml2json < workflow.yaml > workflow.json
 
 
 Add fireworks to LaunchPad