diff --git a/rst/modules.rst b/rst/modules.rst
index 2c0ba42e2d..7856372e52 100644
--- a/rst/modules.rst
+++ b/rst/modules.rst
@@ -184,7 +184,7 @@ All parameters available to the file module are also available when running the
 
 *dest*:
 
-* absolute path to a file on the filesystem.
+* alias for 'path'. Sets an absolute path to a file on the filesystem when used with 'state=file'. When used with 'state=link', sets the destination to create a symbolic link defined by 'src' key.
 
 *state*:
 
@@ -206,10 +206,6 @@ All parameters available to the file module are also available when running the
 
 * path of the file to link to (applies only to 'link' state)
 
-*dest*:
-
-* location where the symlink will be created for 'link' state, also an alias for 'path'.
-
 *seuser*:
 
 * 'user' part of SELinux file context.  Will default to what is provided by system policy, if available.  Only used on systems with SELinux present.  If you specify '_default', it will use the 'user' portion of default context from the policy if available.
diff --git a/rst/playbooks.rst b/rst/playbooks.rst
index c837c2ddb5..c45d49ebd7 100644
--- a/rst/playbooks.rst
+++ b/rst/playbooks.rst
@@ -171,7 +171,7 @@ Variables can be used in action lines.   Suppose you defined
 a variable called 'vhost' in the 'vars' section, you could do this::
 
    tasks:
-     - name: make a directory
+     - name: create a virtual host file for $vhost
        action: template src=somefile.j2 dest=/etc/httpd/conf.d/$vhost
 
 Those same variables are usable in templates, which we'll get to later.