diff --git a/README.rst b/README.rst
index fe2e9918..cfce847a 100644
--- a/README.rst
+++ b/README.rst
@@ -1,14 +1,20 @@
-os_swift role
-#############
-:tags: openstack, cloud, ansible, os_swift
+OpenStack-Ansible Swift
+#######################
+:tags: openstack, swift, cloud, ansible
 :category: \*nix
 
-os_swift Role
+Ansible role to install OpenStack Swift and Swift registry.
+
+This role will install the following:
+    * swift
 
 .. code-block:: yaml
 
-    - name: os_swift role
-      hosts: "hosts"
+    - name: Install swift server
+      hosts: swift_all
       user: root
       roles:
-        - { role: "os_swift" }
+        - { role: "os_swift", tags: [ "os-swift" ] }
+      vars:
+        external_lb_vip_address: 172.16.24.1
+        internal_lb_vip_address: 192.168.0.1