add suboptions in ovirt docs (#53934)

* add suboptions in doc_fragments/ovirt

* update ovirt doc fragment module docs

* add ovirt docs_fragment to BOTMETA.yml

.github/BOTMETA.yml

@@ -1096,6 +1096,8 @@ files:
   $plugins/doc_fragments/proxysql.py: *mysql
   $plugins/doc_fragments/ucs.py: *ucs
   $plugins/doc_fragments/vultr.py: *vultr
+  $plugins/doc_fragments/ovirt.py: *ovirt
+  $plugins/doc_fragments/ovirt_facts.py: *ovirt
   $plugins/doc_fragments/xenserver.py:
     maintainers: bvitnik
   $plugins/doc_fragments/hpe3par.py: *hpe3par

lib/ansible/plugins/doc_fragments/ovirt.py

@@ -30,25 +30,55 @@ options:
     auth:
         description:
             - "Dictionary with values needed to create HTTP/HTTPS connection to oVirt:"
-            - C(username)[I(required)] - The name of the user, something like I(admin@internal).
-              Default value is set by I(OVIRT_USERNAME) environment variable.
-            - "C(password)[I(required)] - The password of the user. Default value is set by I(OVIRT_PASSWORD) environment variable."
-            - "C(url) - A string containing the API URL of the server, usually
-            something like `I(https://server.example.com/ovirt-engine/api)`. Default value is set by I(OVIRT_URL) environment variable.
-            Either C(url) or C(hostname) is required."
-            - "C(hostname) - A string containing the hostname of the server, usually
-            something like `I(server.example.com)`. Default value is set by I(OVIRT_HOSTNAME) environment variable.
-            Either C(url) or C(hostname) is required."
-            - "C(token) - Token to be used instead of login with username/password. Default value is set by I(OVIRT_TOKEN) environment variable."
-            - "C(insecure) - A boolean flag that indicates if the server TLS
-            certificate and host name should be checked."
-            - "C(ca_file) - A PEM file containing the trusted CA certificates. The
-            certificate presented by the server will be verified using these CA
-            certificates. If `C(ca_file)` parameter is not set, system wide
-            CA certificate store is used. Default value is set by I(OVIRT_CAFILE) environment variable."
-            - "C(kerberos) - A boolean flag indicating if Kerberos authentication
-            should be used instead of the default basic authentication."
-            - "C(headers) - Dictionary of HTTP headers to be added to each API call."
+        suboptions:
+            username:
+                description:
+                    - The name of the user, something like I(admin@internal).
+                    - Default value is set by C(OVIRT_USERNAME) environment variable.
+                type: str
+                required: true
+            password:
+                description:
+                    - The password of the user.
+                    - Default value is set by C(OVIRT_PASSWORD) environment variable.
+                type: str
+                required: true
+            url:
+                description:
+                    - A string containing the API URL of the server, usually something like `I(https://server.example.com/ovirt-engine/api)`.
+                    - Default value is set by C(OVIRT_URL) environment variable.
+                    - Either C(url) or C(hostname) is required.
+                type: str
+            hostname:
+                description:
+                    - A string containing the hostname of the server, usually something like `I(server.example.com)`.
+                    - Default value is set by C(OVIRT_HOSTNAME) environment variable.
+                    - Either C(url) or C(hostname) is required.
+                type: str
+            token:
+                description:
+                    - Token to be used instead of login with username/password.
+                    - Default value is set by C(OVIRT_TOKEN) environment variable.
+                type: str
+            insecure:
+                description:
+                    - A boolean flag that indicates if the server TLS certificate and host name should be checked.
+                type: bool
+            ca_file:
+                description:
+                    - A PEM file containing the trusted CA certificates.
+                    - The certificate presented by the server will be verified using these CA certificates.
+                    - If C(ca_file) parameter is not set, system wide CA certificate store is used.
+                    - Default value is set by C(OVIRT_CAFILE) environment variable.
+                type: str
+            kerberos:
+                description:
+                    -  A boolean flag indicating if Kerberos authentication should be used instead of the default basic authentication.
+                type: bool
+            headers:
+                description:
+                    - Dictionary of HTTP headers to be added to each API call.
+                type: dict
         type: dict
         required: true
     timeout: