Autogenerate vm resource docs (#285)

* Autogenerate vm resource docs with tfplugindocs

* Attempt at fixing bash command rendering

* Another attempt at fixing bash command rendering

* More fixes

Author: ddelnano

docs/data-sources/vms.md

@@ -1,10 +1,18 @@
-# xenorchestra_vms
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "xenorchestra_vms Data Source - terraform-provider-xenorchestra"
+subcategory: ""
+description: |-
+  Use this data source to filter Xenorchestra VMs by certain criteria (poolid, powerstate or host) for use in other resources.
+---
+
+# xenorchestra_vms (Data Source)
 
 Use this data source to filter Xenorchestra VMs by certain criteria (pool_id, power_state or host) for use in other resources.
 
 ## Example Usage
 
-```hcl
+```terraform
 data "xenorchestra_pool" "pool" {
   name_label = "Your pool"
 }
@@ -25,28 +33,81 @@ output "vms_length" {
 }
 ```
 
-## Argument Reference
-
-* pool_id - (Required) The ID of the pool the vms belong to.
-* host - (Optional) The ID of the host (container) the vms belong to.
-* power_state - (Optional) The power state of the vms. ("Running" / "Halted")
-
-## Attributes Reference
-
-* id - The CRC-32 checksum based on arguments passed to this data source.
-* pool_id - The ID of the pool the VM belongs to.
-* vms - A list of information for all vms found in this pool.
-    * vms.id - The uuid for the VM.
-    * vms.name_label - The name label for the VM.
-    * vms.cpu - The number of cpu's for the VM.
-    * vms.cloud_config - The cloud configuration for the VM.
-    * vms.cloud_network_config - The cloud network configuration for the VM.
-    * vms.tags - The tags applied to the VM.
-    * vms.memory_max - The maximum memory size for the VM.
-    * vms.affinity_host - The affinity host for the VM.
-    * vms.template - The template used to create the VM.
-    * vms.wait_for_ip - The wait for ip option for the VM.
-    * vms.high_availability - The high availability option for the VM.
-    * vms.resource_set - The resource set for the VM.
-    * vms.ipv4_addresses - A list of ipv4 addresses for the VM.
-    * vms.ipv6_addresses - A list of ipv6 addresses for the VM.
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `pool_id` (String) The ID of the pool the VM belongs to.
+
+### Optional
+
+- `host` (String)
+- `power_state` (String) The power state of the vms. (Running, Halted)
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `vms` (List of Object) A list of information for all vms found in this pool. (see [below for nested schema](#nestedatt--vms))
+
+<a id="nestedatt--vms"></a>
+### Nested Schema for `vms`
+
+Read-Only:
+
+- `affinity_host` (String)
+- `auto_poweron` (Boolean)
+- `blocked_operations` (Set of String)
+- `cloud_config` (String)
+- `cloud_network_config` (String)
+- `core_os` (Boolean)
+- `cpu_cap` (Number)
+- `cpu_weight` (Number)
+- `cpus` (Number)
+- `disk` (List of Object) (see [below for nested schema](#nestedobjatt--vms--disk))
+- `exp_nested_hvm` (Boolean)
+- `high_availability` (String)
+- `host` (String)
+- `hvm_boot_firmware` (String)
+- `id` (String)
+- `ipv4_addresses` (List of String)
+- `ipv6_addresses` (List of String)
+- `memory_max` (Number)
+- `name_description` (String)
+- `name_label` (String)
+- `network` (List of Object) (see [below for nested schema](#nestedobjatt--vms--network))
+- `power_state` (String)
+- `resource_set` (String)
+- `start_delay` (Number)
+- `tags` (Set of String)
+- `template` (String)
+- `vga` (String)
+- `videoram` (Number)
+- `wait_for_ip` (Boolean)
+
+<a id="nestedobjatt--vms--disk"></a>
+### Nested Schema for `vms.disk`
+
+Read-Only:
+
+- `attached` (Boolean)
+- `name_description` (String)
+- `name_label` (String)
+- `position` (String)
+- `size` (Number)
+- `sr_id` (String)
+- `vbd_id` (String)
+- `vdi_id` (String)
+
+
+<a id="nestedobjatt--vms--network"></a>
+### Nested Schema for `vms.network`
+
+Read-Only:
+
+- `attached` (Boolean)
+- `device` (String)
+- `ipv4_addresses` (List of String)
+- `ipv6_addresses` (List of String)
+- `mac_address` (String)
+- `network_id` (String)

docs/index.md

@@ -46,11 +46,14 @@ provider "xenorchestra" {
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
+### Required
+
+- `password` (String) Password for xoa api. Can be set via the XOA_PASSWORD environment variable.
+- `url` (String) Hostname of the xoa router. Can be set via the XOA_URL environment variable.
+- `username` (String) User account for xoa api. Can be set via the XOA_USER environment variable.
+
 ### Optional
 
 - `insecure` (Boolean) Whether SSL should be verified or not. Can be set via the XOA_INSECURE environment variable.
-- `password` (String) Password for xoa api. Can be set via the XOA_PASSWORD environment variable.
 - `retry_max_time` (String) If `retry_mode` is set, this specifies the duration for which the backoff method will continue retries. Can be set via the `XOA_RETRY_MAX_TIME` environment variable
 - `retry_mode` (String) Specifies if retries should be attempted for requests that require eventual . Can be set via the XOA_RETRY_MODE environment variable.
-- `url` (String) Hostname of the xoa router. Can be set via the XOA_URL environment variable.
-- `username` (String) User account for xoa api. Can be set via the XOA_USER environment variable.