From b69bcdd0c493e76c4f44db501ce3bfa39ea647b5 Mon Sep 17 00:00:00 2001 From: The Magician Date: Fri, 15 Nov 2019 11:11:41 -0800 Subject: [PATCH] Add a section about 3.0.0-beta.1 to the upgrade guide (#4917) Signed-off-by: Modular Magician --- .../docs/guides/version_3_upgrade.html.markdown | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/website/docs/guides/version_3_upgrade.html.markdown b/website/docs/guides/version_3_upgrade.html.markdown index 1b808df2c57..6bb22b05db0 100644 --- a/website/docs/guides/version_3_upgrade.html.markdown +++ b/website/docs/guides/version_3_upgrade.html.markdown @@ -20,6 +20,23 @@ such as deprecation notices, can always be found in the CHANGELOG of the affected providers. [google](https://github.com/terraform-providers/terraform-provider-google/blob/master/CHANGELOG.md) [google-beta](https://github.com/terraform-providers/terraform-provider-google-beta/blob/master/CHANGELOG.md) +## What is `3.0.0-beta.1`? + +With `3.0.0`, we introduced a prerelease window for our major provider releases. +`3.0.0-beta.1` contains all of the changes in `3.0.0`, and allows you to test it +prior to the full upgrade. Currently `3.0.0` is not expected to contain new +features not available in `3.0.0-beta.1`, only bugfixes for issues we're made +aware of before `3.0.0`'s release. Using `3.0.0-beta.1` in production is not +recommended. + +```hcl +provider "google" { + # ... other configuration ... + + version = "~> 3.0.0-beta.1" +} +``` + ## I accidentally upgraded to 3.0.0, how do I downgrade to `2.X`? If you've inadvertently upgraded to `3.0.0`, first see the