misc: update changelog and upgrade guide

Author: sudomateo

.changelog/0.21.0.toml

@@ -6,20 +6,12 @@ description = "The `id` attribute for the `oxide_ip_pool_silo_link` resource now
 
 [[enhancements]]
 title = "Validate UUID Attributes"
-description = "Attributes that expect UUIDs now validate whether their values are, in fact, valid UUIDs. This catches cases where names passed to attributes accidentally worked. [#795](https://github.com/oxidecomputer/terraform-provider-oxide/issues/795)."
+description = "Attributes that expect UUIDs now validate whether their values are, in fact, valid UUIDs. This catches cases where names passed to attributes expecting UUIDs accidentally worked. [#795](https://github.com/oxidecomputer/terraform-provider-oxide/pull/795)."
 
 [[bugs]]
 title = "`oxide_ip_pool_silo_link`"
-description = "The composite `id` attribute, formatted as `IP_POOL_ID/SILO_ID`, now resolves `SILO_ID` to its UUID, even if the `silo_id` attribute was previously configured by name."
+description = "The `silo_id` attribute now resolves to the silo's UUID, even if the attribute was previously configured by name. [#795](https://github.com/oxidecomputer/terraform-provider-oxide/pull/795)."
 
 [[bugs]]
 title = "`oxide_subnet_pool_silo_link`"
-description = "The composite `id` attribute, formatted as `SUBNET_POOL_ID/SILO_ID`, now resolves `SILO_ID` to its UUID, even if the `silo_id` attribute was previously configured by name."
-
-[[bugs]]
-title = "`oxide_ip_pool_silo_link`"
-description = "The `silo_id` attribute now resolves to the silo's UUID, even if the attribute was previously configured by name."
-
-[[bugs]]
-title = "`oxide_subnet_pool_silo_link`"
-description = "The `silo_id` attribute now resolves to the silo's UUID, even if the attribute was previously configured by name."
+description = "The `silo_id` attribute now resolves to the silo's UUID, even if the attribute was previously configured by name. [#795](https://github.com/oxidecomputer/terraform-provider-oxide/pull/795)."

docs/guides/upgrade.md

@@ -17,6 +17,46 @@ Refer to the
 [changelog](https://github.com/oxidecomputer/terraform-provider-oxide/blob/main/CHANGELOG.md)
 for a full list of changes.
 
+## Upgrading to `0.21.0`
+
+Release `0.21.0` contains breaking changes that require updates to Terraform
+configuration files.
+
+### UUID Validation
+
+Attributes that expect UUIDs now validate whether their values are, in fact,
+valid UUIDs. This catches cases where names passed to attributes expecting UUIDs
+accidentally worked.
+
+Terraform plans will fail with an `Invalid UUID` error on affected attributes.
+
+```
+╷
+│ Error: Invalid UUID
+│
+│   with oxide_ip_pool_silo_link.example,
+│   on main.tf line 15, in resource "oxide_ip_pool_silo_link" "example":
+│   15:   silo_id    = "oxide"
+│
+│ Attribute silo_id value must be a valid UUID, got: oxide
+╵
+```
+
+Update the attribute to its UUID to comply with the validation.
+
+```diff
+--- main.tf
++++ main.tf
+ }
+
+ resource "oxide_ip_pool_silo_link" "example" {
+-  silo_id    = "oxide"
++  silo_id    = "338bfaf2-75d3-4a1c-8850-32173960f658"
+   ip_pool_id = "c6f8c195-8cee-40b5-bc95-7eb86edec285"
+   is_default = false
+ }
+```
+
 ## Upgrading to `0.20.0`
 
 Release `0.20.0` contains breaking changes that require updates to Terraform

templates/guides/upgrade.md.tmpl

@@ -17,6 +17,46 @@ Refer to the
 [changelog](https://github.com/oxidecomputer/terraform-provider-oxide/blob/main/CHANGELOG.md)
 for a full list of changes.
 
+## Upgrading to `0.21.0`
+
+Release `0.21.0` contains breaking changes that require updates to Terraform
+configuration files.
+
+### UUID Validation
+
+Attributes that expect UUIDs now validate whether their values are, in fact,
+valid UUIDs. This catches cases where names passed to attributes expecting UUIDs
+accidentally worked.
+
+Terraform plans will fail with an `Invalid UUID` error on affected attributes.
+
+```
+╷
+│ Error: Invalid UUID
+│
+│   with oxide_ip_pool_silo_link.example,
+│   on main.tf line 15, in resource "oxide_ip_pool_silo_link" "example":
+│   15:   silo_id    = "oxide"
+│
+│ Attribute silo_id value must be a valid UUID, got: oxide
+╵
+```
+
+Update the attribute to its UUID to comply with the validation.
+
+```diff
+--- main.tf
++++ main.tf
+ }
+
+ resource "oxide_ip_pool_silo_link" "example" {
+-  silo_id    = "oxide"
++  silo_id    = "338bfaf2-75d3-4a1c-8850-32173960f658"
+   ip_pool_id = "c6f8c195-8cee-40b5-bc95-7eb86edec285"
+   is_default = false
+ }
+```
+
 ## Upgrading to `0.20.0`
 
 Release `0.20.0` contains breaking changes that require updates to Terraform