Merge "Minor doc fixups in ansible-deployment.md"

1 files changed, 13 insertions, 6 deletions

diff --git a/docs/ansible-deployment.md b/docs/ansible-deployment.md
index 8bee0e895..8aee3a0a5 100644
--- a/docs/ansible-deployment.md
+++ b/docs/ansible-deployment.md
@@ -1,4 +1,4 @@
-Koalla - Kolla with ansible!
+Koalla - Kolla with Ansible!
 ============================
 
 Koalla extends the Kolla project past [TripleO][] into its own bonified
@@ -12,12 +12,17 @@ deployment system using [Ansible][] and [docker-compose][].
 Getting Started
 ---------------
 
-To run the ansible playbooks, you must specify an inventory file which tracks
+To run the Ansible playbooks, you must specify an inventory file which tracks
 all of the available nodes in your environment. With this inventory file
-ansible will log into each node via ssh (configurable) and run tasks. Ansible
+Ansible will log into each node via ssh (configurable) and run tasks. Ansible
 does not require password less logins via ssh, however it is highly recommended
-to setup ssh-keys. More information on the ansible inventory file can be found
-[here][].
+to setup ssh-keys.
+
+Two sample inventory files are provided, *all-in-one*, and *multinode*. The
+"all-in-one" inventory defaults to use the Ansible "local" connection type,
+which removes the need to setup ssh keys in order to get started quickly.
+
+More information on the Ansible inventory file can be found [here][].
 
 [here]: https://docs.ansible.com/intro_inventory.html
 
@@ -27,6 +32,8 @@ Deploying
 
 You can adjust variables for your environment in the file:
 "./kolla/ansible/group_vars/all.yml"
+Ensure that the *koalla_directory* variable matches where you have Kolla cloned
+on the target machine(s).
 
 For All-In-One deploys, you can run the following commands. These will setup all
 of the containers on your localhost.
@@ -34,7 +41,7 @@ of the containers on your localhost.
     cd ./kolla/ansible
     ansible-playbook -i inventory/all-in-one site.yml
 
-To run the playbooks for only a particular service, you can us ansible tags.
+To run the playbooks for only a particular service, you can use Ansible tags.
 Multiple tags may be specified, and order is still determined by the playbooks.
 
     cd ./kolla/ansible