diff --git a/docs/upgrading_to_v18.0.md b/docs/upgrading_to_v18.0.md
index 1a759e78f2..7f503017a4 100644
--- a/docs/upgrading_to_v18.0.md
+++ b/docs/upgrading_to_v18.0.md
@@ -41,10 +41,11 @@ have been eliminated.
 ```
 
 ### Acceptable values for node_metadata modified
-The `node_metadata` variable should now be set to one of `GKE_METADATA`,
+It is recommended to update `node_metadata` variable to one of `GKE_METADATA`,
 `GCE_METADATA` or `UNSPECIFIED`. `GKE_METADATA` replaces the previous
 `GKE_METADATA_SERVER` value, `GCE_METADATA` should be used in place of
-`EXPOSE`. The `SECURE` option, previously deprecated, has now been removed.
+`EXPOSE`, however old values continue to be supported for backwards compatibility.
+The `SECURE` option, previously deprecated, has now been removed.
 
 ```diff
 module "gke" {
diff --git a/docs/upgrading_to_v8.0.md b/docs/upgrading_to_v8.0.md
index 913a9b060e..5d0f0aea7b 100644
--- a/docs/upgrading_to_v8.0.md
+++ b/docs/upgrading_to_v8.0.md
@@ -4,7 +4,7 @@ The v8.0 release of *kubernetes-engine* is a backwards incompatible
 release.
 
 ## Workload Identity (beta)
-Beta clusters now have Workload Identity enabled by default. To disable Workload Identity, set `workload_pool = null`
+Beta clusters now have Workload Identity enabled by default. To disable Workload Identity, set `identity_namespace = null`
 
 ## Shielded Nodes (beta)
 Beta clusters now have shielded nodes enabled by default. To disable, set `enable_shielded_nodes = false`