os_flavors: Update README

Author: markgoddard

roles/os_flavors/README.md

@@ -1,13 +1,13 @@
 OpenStack Flavors
 =================
 
-This role can be used to register flavors in nova using the
-openstack.cloud.compute\_flavor module.
+This role can be used to register flavors in Nova using the
+`openstack.cloud.compute_flavor` module.
 
 Requirements
 ------------
 
-The OpenStack nova API should be accessible from the target host.
+The OpenStack Nova API should be accessible from the target host.
 
 Role Variables
 --------------
@@ -16,17 +16,17 @@ Role Variables
 virtualenv.
 
 `os_flavors_auth_type` is an authentication type compatible with
-the `auth_type` argument of `os_*` Ansible modules.
+the `auth_type` argument of `openstack.cloud` Ansible modules.
 
 `os_flavors_auth` is a dict containing authentication information
-compatible with the `auth` argument of `os_*` Ansible modules.
+compatible with the `auth` argument of `openstack.cloud` Ansible modules.
 
 `os_flavors_cacert` is an optional path to a CA certificate bundle.
 
 `os_flavors_interface` is the endpoint URL type to fetch from the service
 catalog. Maybe be one of `public`, `admin`, or `internal`.
 
-`os_flavors` is a list of nova flavors to register. Each item should be a dict
+`os_flavors` is a list of Nova flavors to register. Each item should be a dict
 containing the items 'name', 'ram', 'disk', and 'vcpus'. Optionally, the dict
 may contain 'ephemeral', 'flavorid', 'rxtx_factor' and 'swap' items.
 Optionally, the dict may also contain an item 'extra_specs', which is a dict of
@@ -35,18 +35,18 @@ metadata to attach to the flavor object.
 Dependencies
 ------------
 
-This role depends on the `stackhpc.os_openstacksdk` role.
+This role depends on the `stackhpc.openstack.os_openstacksdk` role.
 
 Example Playbook
 ----------------
 
-The following playbook registers a nova flavor.
+The following playbook registers a Nova flavor.
 
     ---
-    - name: Ensure nova flavors are registered
-      hosts: nova-api
+    - name: Ensure Nova flavors are registered
+      hosts: localhost
       roles:
-        - role: os-flavors
+        - role: stackhpc.openstack.os_flavors
           os_flavors_venv: "~/os-flavors-venv"
           os_flavors_auth_type: "password"
           os_flavors_auth: