docs: fix and standardize doc pages (#544)

Adjust spelling of IP pool to match the rest of the documentation page.

Author: lgfa29

docs/data-sources/floating_ip.md

@@ -36,7 +36,7 @@ data "oxide_floating_ip" "example" {
 - `description` (String) Human-readable free-form text about the floating IP.
 - `id` (String) Unique, immutable, system-controlled identifier for the floating IP.
 - `instance_id` (String) Instance ID that this floating IP is attached to, if presently attached.
-- `ip` (String) IP address for this floating IP. If unset an IP address will be chosen from the given ip_pool_id.
+- `ip` (String) IP address for this floating IP. If unset an IP address will be chosen from the given `ip_pool_id`.
 - `ip_pool_id` (String) IP pool ID to allocate this floating IP from. If unset the silo's default IP pool is used.
 - `project_id` (String) Project ID where this floating IP is located.
 - `time_created` (String) Timestamp when this floating IP was created.

docs/data-sources/image.md

@@ -31,7 +31,7 @@ data "oxide_image" "example" {
 
 ### Optional
 
-- `project_name` (String) Name of the project which contains the images
+- `project_name` (String) Name of the project which contains the image.
 - `timeouts` (Attributes) (see [below for nested schema](#nestedatt--timeouts))
 
 ### Read-Only
@@ -41,7 +41,7 @@ data "oxide_image" "example" {
 - `digest` (Attributes) Hash of the image contents, if applicable. (see [below for nested schema](#nestedatt--digest))
 - `id` (String) Unique, immutable, system-controlled identifier of the image.
 - `os` (String) OS image distribution.
-- `project_id` (String) ID of the project which contains the images
+- `project_id` (String) ID of the project which contains the image.
 - `size` (Number) Size of the image in bytes.
 - `time_created` (String) Timestamp of when this image was created.
 - `time_modified` (String) Timestamp of when this image was last modified.

docs/data-sources/images.md

@@ -21,7 +21,7 @@ data "oxide_images" "example" {}
 
 ### Optional
 
-- `project_id` (String) ID of the project which contains the images
+- `project_id` (String) ID of the project which contains the images.
 - `timeouts` (Attributes) (see [below for nested schema](#nestedatt--timeouts))
 
 ### Read-Only

docs/data-sources/silo.md

@@ -3,12 +3,12 @@
 page_title: "oxide_silo Data Source - terraform-provider-oxide"
 subcategory: ""
 description: |-
-  Retrieve information about a specified Silo.
+  Retrieve information about a specified silo.
 ---
 
 # oxide_silo (Data Source)
 
-Retrieve information about a specified Silo.
+Retrieve information about a specified silo.
 
 ## Example Usage
 
@@ -26,20 +26,20 @@ data "oxide_silo" "example" {
 
 ### Required
 
-- `name` (String) Name of the Silo.
+- `name` (String) Name of the silo.
 
 ### Optional
 
 - `timeouts` (Attributes) (see [below for nested schema](#nestedatt--timeouts))
 
 ### Read-Only
 
-- `description` (String) Description for the Silo.
-- `discoverable` (Boolean) A silo where discoverable is false can be retrieved only by its ID - it will not be part of the 'list all silos' output
-- `id` (String) Unique, immutable, system-controlled identifier of the Silo.
-- `identity_mode` (String) How users and groups are managed in this Silo.
-- `time_created` (String) Timestamp of when this Silo was created.
-- `time_modified` (String) Timestamp of when this Silo was last modified.
+- `description` (String) Description for the silo.
+- `discoverable` (Boolean) A silo where discoverable is false can be retrieved only by its ID - it will not be part of the 'list all silos' output.
+- `id` (String) Unique, immutable, system-controlled identifier of the silo.
+- `identity_mode` (String) How users and groups are managed in this silo.
+- `time_created` (String) Timestamp of when this silo was created.
+- `time_modified` (String) Timestamp of when this silo was last modified.
 
 <a id="nestedatt--timeouts"></a>
 ### Nested Schema for `timeouts`

docs/data-sources/system_ip_pools.md

@@ -3,14 +3,22 @@
 page_title: "oxide_system_ip_pools Data Source - terraform-provider-oxide"
 subcategory: ""
 description: |-
-  
+  Retrieve all configured IP pools for the Oxide system.
 ---
 
 # oxide_system_ip_pools (Data Source)
 
+Retrieve all configured IP pools for the Oxide system.
 
+## Example Usage
 
-
+```terraform
+data "oxide_system_ip_pools" "example" {
+  timeouts = {
+    read = "1m"
+  }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/vpc_router_route.md

@@ -62,18 +62,23 @@ Optional:
 
 Read-Only:
 
-- `type` (String) Route destination type. Possible values: `vpc`, `subnet`, `ip`, `ip_net`
+- `type` (String) Route destination type. Possible values: `vpc`, `subnet`, `ip`, `ip_net`.
 - `value` (String) Depending on the type, it will be one of the following:
-  - `vpc`: Name of the VPC
-  - `subnet`: Name of the VPC subnet
-  - `ip`: IP address
-  - `ip_net`: IPv4 or IPv6 subnet
+  - `vpc`: Name of the VPC.
+  - `subnet`: Name of the VPC subnet.
+  - `ip`: IP address.
+  - `ip_net`: IPv4 or IPv6 subnet.
 
 
 <a id="nestedatt--target"></a>
 ### Nested Schema for `target`
 
 Read-Only:
 
-- `type` (String) Route destination type. Possible values: vpc, subnet, instance, ip, internet_gateway, drop
-- `value` (String) Depending on the type, it will be one of the following:- `vpc`: Name of the VPC - `subnet`: Name of the VPC subnet - `instance`: Name of the instance- `ip`: IP address - `internet_gateway`: name of the internet gateway
+- `type` (String) Route destination type. Possible values: `vpc`, `subnet`, `instance`, `ip`, `internet_gateway`, `drop`.
+- `value` (String) Depending on the type, it will be one of the following:
+  - `vpc`: Name of the VPC.
+  - `subnet`: Name of the VPC subnet.
+  - `instance`: Name of the instance.
+  - `ip`: IP address.
+  - `internet_gateway`: Name of the internet gateway.

docs/resources/anti_affinity_group.md

@@ -34,7 +34,7 @@ resource "oxide_anti_affinity_group" "example" {
 
 - `description` (String) Description for the anti-affinity group.
 - `name` (String) Name of the anti-affinity group.
-- `policy` (String) Affinity policy used to describe what to do when a request cannot be satisfied
+- `policy` (String) Affinity policy used to describe what to do when a request cannot be satisfied.
 - `project_id` (String) ID of the project that will contain the anti-affinity group.
 
 ### Optional

docs/resources/image.md

@@ -34,10 +34,10 @@ resource "oxide_image" "example2" {
 
 - `description` (String) Description for the image.
 - `name` (String) Name of the image.
-- `os` (String) OS image distribution. Example: alpine
+- `os` (String) OS image distribution. Example: `"alpine"`.
 - `project_id` (String) ID of the project that will contain the image.
 - `source_snapshot_id` (String) Snapshot ID of the image source if applicable.
-- `version` (String) OS image version. Example: 3.16.
+- `version` (String) OS image version. Example: `"3.16"`.
 
 ### Optional
 

docs/resources/instance.md

@@ -106,7 +106,7 @@ resource "oxide_instance" "example" {
 ### Required
 
 - `description` (String) Description for the instance.
-- `host_name` (String) Host name of the instance
+- `host_name` (String) Host name of the instance.
 - `memory` (Number) Instance memory in bytes.
 - `name` (String) Name of the instance.
 - `ncpus` (Number) Number of CPUs allocated for this instance.
@@ -115,7 +115,7 @@ resource "oxide_instance" "example" {
 ### Optional
 
 - `anti_affinity_groups` (Set of String) IDs of the anti-affinity groups this instance should belong to.
-- `auto_restart_policy` (String)
+- `auto_restart_policy` (String) The auto-restart policy for this instance.
 - `boot_disk_id` (String) ID of the disk the instance should be booted from. When provided, this ID must also be present in `disk_attachments`.
 - `disk_attachments` (Set of String) IDs of the disks to be attached to the instance. When multiple disk IDs are provided, set `book_disk_id` to specify the boot disk for the instance. Otherwise, a boot disk will be chosen randomly.
 - `external_ips` (Attributes Set) External IP addresses provided to this instance. (see [below for nested schema](#nestedatt--external_ips))
@@ -142,7 +142,7 @@ Required:
 
 Optional:
 
-- `id` (String) If `type` is `ephemeral`, ID of the IP pool to retrieve addresses from, or all available pools if not specified. If `type` is `floating`, ID of the floating IP
+- `id` (String) If `type` is `ephemeral`, ID of the IP pool to retrieve addresses from, or all available pools if not specified. If `type` is `floating`, ID of the floating IP.
 
 
 <a id="nestedatt--network_interfaces"></a>
@@ -153,7 +153,7 @@ Required:
 - `description` (String) Description for the instance network interface.
 - `name` (String) Name of the instance network interface.
 - `subnet_id` (String) ID of the VPC subnet in which to create the instance network interface.
-- `vpc_id` (String) ID of the VPC in which to create the instance network interface
+- `vpc_id` (String) ID of the VPC in which to create the instance network interface.
 
 Optional:
 

docs/resources/ip_pool.md

@@ -55,8 +55,8 @@ resource "oxide_ip_pool" "example" {
 
 Required:
 
-- `first_address` (String) First address in the range
-- `last_address` (String) Last address in the range
+- `first_address` (String) First address in the range.
+- `last_address` (String) Last address in the range.
 
 
 <a id="nestedatt--timeouts"></a>