[DOCS] Add project links; fix indents; wording

Change-Id: Ie5225d641c2db96ca314ab54613588408eb77005

README.rst

@@ -2,6 +2,11 @@
 OpenStack-Ansible glance
 ========================
 
-This Ansible role installs and configures OpenStack glance and glance
-registry.
+This Ansible role installs and configures OpenStack glance and the
+glance registry.
 
+Documentation for the project can be found at:
+  http://docs.openstack.org/developer/openstack-ansible-os_glance/
+
+The project home is at:
+  http://launchpad.net/openstack-ansible

doc/source/configure-glance.rst

@@ -16,10 +16,10 @@ file-based storage by default. Two additional stores, ``http`` and ``cinder``
 (Block Storage), are also enabled by default.
 
 You can choose alternative default stores and alternative additional stores.
-For example, a deployer that uses Ceph may configure the following Ansible
+For example, a deployer that uses Ceph can configure the following Ansible
 variables:
 
-.. code-block:: yaml
+ .. code-block:: yaml
 
     glance_default_store = rbd
     glance_additional_stores:

doc/source/index.rst

@@ -1,19 +1,29 @@
-=================================
-Glance role for OpenStack-Ansible
-=================================
+=============================
+OpenStack-Ansible glance role
+=============================
 
 .. toctree::
    :maxdepth: 2
 
    configure-glance.rst
 
-:tags: openstack, glance, cloud, ansible
-:category: \*nix
+This role installs the following Upstart services:
 
-This role will install the following Upstart services:
     * glance-api
     * glance-registry
 
+Default variables
+~~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../defaults/main.yml
+   :language: yaml
+   :start-after: under the License.
+
+Required variables
+~~~~~~~~~~~~~~~~~~
+
+None
+
 Example playbook
 ~~~~~~~~~~~~~~~~
 
@@ -23,8 +33,9 @@ Example playbook
 Tags
 ~~~~
 
-This role supports two tags: ``glance-install`` and ``glance-config``
+This role supports two tags: ``glance-install`` and ``glance-config``.
+The ``glance-install`` tag can be used to install and upgrade. The
+``glance-config`` tag can be used to manage configuration.
 
-The ``glance-install`` tag can be used to install and upgrade.
-
-The ``glance-config`` tag can be used to manage configuration.
+:tags: openstack, glance, cloud, ansible
+:category: \*nix

examples/playbook.yml

@@ -1,4 +1,4 @@
-    - name: Install glance server
+- name: Install glance server
   hosts: glance_all
   user: root
   roles: