diff --git a/docs/upgrading_to_v10.0.0.md b/docs/upgrading_to_v10.0.0.md
new file mode 100644
index 00000000..28357282
--- /dev/null
+++ b/docs/upgrading_to_v10.0.0.md
@@ -0,0 +1,5 @@
+# Upgrading to v10.0.0
+
+The v10.0 release contains backwards-incompatible changes.
+
+This update requires upgrading the minimum provider version of `hashicorp/google` from `3.50` to `5.8` and `hashicorp/google-beta` from `3.50` to `5.8`.