doc fixes

lib/ansible/modules/cloud/openstack/os_image_facts.py

@@ -22,7 +22,6 @@ except ImportError:
     HAS_SHADE = False
 
 DOCUMENTATION = '''
----
 module: os_image_facts
 short_description: Retrieve facts about an image within OpenStack.
 version_added: "2.0"
@@ -55,74 +54,76 @@ EXAMPLES = '''
 '''
 
 RETURN = '''
-This module registers image details in facts named: openstack_image.  When
+openstack_image:
-image is not found, openstack_image will be null.
+    description: has all the openstack facts about the image
-
+    returned: always, but can be null
-id:
+    type: complex
+    contains:
+        id:
             description: Unique UUID.
             returned: success
             type: string
-name:
+        name:
             description: Name given to the image.
             returned: success
             type: string
-status:
+        status:
             description: Image status.
             returned: success
             type: string
-created_at:
+        created_at:
             description: Image created at timestamp.
             returned: success
             type: string
-deleted:
+        deleted:
             description: Image deleted flag.
             returned: success
             type: boolean
-container_format:
+        container_format:
             description: Container format of the image.
             returned: success
             type: string
-min_ram:
+        min_ram:
             description: Min amount of RAM required for this image.
             returned: success
             type: int
-disk_format:
+        disk_format:
             description: Disk format of the image.
             returned: success
             type: string
-updated_at:
+        updated_at:
             description: Image updated at timestamp.
             returned: success
             type: string
-properties:
+        properties:
             description: Additional properties associated with the image.
             returned: success
             type: dict
-min_disk:
+        min_disk:
             description: Min amount of disk space required for this image.
             returned: success
             type: int
-protected:
+        protected:
             description: Image protected flag.
             returned: success
             type: boolean
-checksum:
+        checksum:
             description: Checksum for the image.
             returned: success
             type: string
-owner:
+        owner:
             description: Owner for the image.
             returned: success
             type: string
-is_public:
+        is_public:
             description: Is plubic flag of the image.
             returned: success
             type: boolean
-deleted_at:
+        deleted_at:
             description: Image deleted at timestamp.
             returned: success
             type: string
-size:
+        size:
             description: Size of the image.
             returned: success
             type: int

lib/ansible/modules/cloud/openstack/os_networks_facts.py

@@ -82,30 +82,32 @@ EXAMPLES = '''
 '''
 
 RETURN = '''
-This module registers network details in facts named: openstack_networks.  If a
+openstack_networks:
-network name/id and or filter does not result in a network found, an empty
+    description: has all the openstack facts about the networks
-list is set in openstack_networks.
+    returned: always, but can be null
-id:
+    type: complex
+    contains:
+        id:
             description: Unique UUID.
             returned: success
             type: string
-name:
+        name:
             description: Name given to the network.
             returned: success
             type: string
-status:
+        status:
             description: Network status.
             returned: success
             type: string
-subnets:
+        subnets:
             description: Subnet(s) included in this network.
             returned: success
             type: list of strings
-tenant_id:
+        tenant_id:
             description: Tenant id associated with this network.
             returned: success
             type: string
-shared:
+        shared:
             description: Network shared flag.
             returned: success
             type: boolean

lib/ansible/modules/cloud/openstack/os_server.py

@@ -86,8 +86,8 @@ options:
         - A list of networks to which the instance's interface should
           be attached. Networks may be referenced by net-id/net-name/port-id
           or port-name.
-          Also this accepts a string containing a list of net-id/port-id.
+        - 'Also this accepts a string containing a list of net-id/port-id.
-          Eg: nics: "net-id=uuid-1,net-id=uuid-2"
+          Eg: nics: "net-id=uuid-1,net-id=uuid-2"'
      required: false
      default: None
    public_ip: