The existing description does not make 2 things clear.
1) This is an environment variable
2) It must be set on the _controlling_ host, not the remote host.

link to core modules source is broken since restructuring of public ansible repos

other SCM sourced in line 96

Fixes https://github.com/ansible/ansible/issues/9202

Also remove a few whitespaces, improve the bash script and fix a typo.

Clarify which of the options to pick.

Missing code block

Added `--init --recursive` to installation instructions
as per @bcoca's suggestion on ansible-project mailing list

All examples do not show it, so only someone reading the doc from
end to end would know about it.

very small and minor addition, but I couldn't find anywhere that answered this (now obvious) question I had of whether or not facts could also be yaml files.

This avoids passing the plaintext raw password into the script as a
command-line argument, which shells such as bash and zsh will
typically log into a file like ~/bash_history.

As a small bonus, this works a LOT more smoothly if the user's
password has characters in it that either the shell or Python syntax
might like to interpret as metacharacters, like '\' or '"'.

getpass.getpass() is part of Python's standard library in all versions
between 2.4 and 3.3 at least.

Defaults to the system wide `roles-path` when `path` is not specified in the
provided `role-file`.  An example installing nginx to a relative path specified
by the `role-file`.

    - src: https://github.com/bennojoy/nginx
      path: vagrant/roles/