diff --git a/third_party/terraform/website/docs/guides/version_3_upgrade.html.markdown b/third_party/terraform/website/docs/guides/version_3_upgrade.html.markdown
index c7c6ec886392..ab699c548611 100644
--- a/third_party/terraform/website/docs/guides/version_3_upgrade.html.markdown
+++ b/third_party/terraform/website/docs/guides/version_3_upgrade.html.markdown
@@ -75,6 +75,7 @@ so Terraform knows to manage them.
 - [Resource: `google_monitoring_alert_policy`](#resource-google_monitoring_alert_policy)
 - [Resource: `google_monitoring_uptime_check_config`](#resource-google_monitoring_uptime_check_config)
 - [Resource: `google_organization_policy`](#resource-google_organization_policy)
+- [Resource: `google_project_iam_audit_config`](#resource-google_project_iam_audit_config)
 - [Resource: `google_project_service`](#resource-google_project_service)
 - [Resource: `google_project_services`](#resource-google_project_services)
 - [Resource: `google_pubsub_subscription`](#resource-google_pubsub_subscription)
@@ -620,6 +621,13 @@ required on the `google_monitoring_uptime_check_config.content_matchers` block.
 In an attempt to avoid allowing empty blocks in config files, `inherit_from_parent` is now
 required on the `google_organization_policy.list_policy` block.
 
+## Resource: `google_project_iam_audit_config`
+
+### Audit configs are now authoritative on create
+
+Audit configs are now authoritative on create, rather than merging with existing configs on create.
+Writing an audit config resource will now overwrite any existing audit configs on the given project.
+
 ## Resource: `google_project_service`
 
 ### `bigquery-json.googleapis.com` service can no longer be specified