add upgrade doc for breaking change

Author: bdashrad

README.md

@@ -13,8 +13,10 @@ intended for Terraform 0.12.x is [v4.5.0](https://registry.terraform.io/modules/
 
 ## Upgrading
 
-The current version is 4.X. The following guides are available to assist with upgrades:
+The current version is 8.X. The following guides are available to assist with upgrades:
 
+- [8.0 -> 9.0](./docs/upgrading_to_bigquery_v9.0.md)
+- [7.0 -> 8.0](./docs/upgrading_to_bigquery_v8.0.md)
 - [3.0 -> 4.0](./docs/upgrading_to_bigquery_v4.0.md)
 - [2.0 -> 3.0](./docs/upgrading_to_bigquery_v3.0.md)
 - [1.0 -> 2.0](./docs/upgrading_to_bigquery_v2.0.md)

docs/upgrading_to_bigquery_v9.0.md

@@ -0,0 +1,49 @@
+# Upgrading to BigQuery v9.0
+
+- The supported provider has been updated to v5.3
+- `require_partition_filter` has been deprecated under the `time_partitioning` block and can be used at the top level with the same name instead. (hashicorp/terraform-provider-google#16238)
+
+## Migration Instructions
+
+In the previous release, `require_partition_filter` was a part of the `time_partitioning` block on a `materialized_views` object.
+
+    ```hcl
+    module "bigquery" {
+      source  = "terraform-google-modules/bigquery/google"
+      version = "~> 8.0"
+      ....
+      materialized_views = [
+        {
+          view_id = "foo",
+          ....
+          time_partitioning  = {
+            ....
+            require_partition_filter = true,
+            ....
+          },
+        }
+      ],
+    ...
+    }
+    ```
+
+In the new release, `require_partition_filter` is a top-level field in the `materialized_views` object.
+
+    ```hcl
+    module "bigquery" {
+      source  = "terraform-google-modules/bigquery/google"
+      version = "~> 9.0"
+      ....
+      materialized_views = [
+        {
+          view_id = "foo",
+          ....
+          require_partition_filter = true,
+          time_partitioning  = {
+            ....
+          },
+        },
+      ],
+    ...
+    }
+    ```