Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update All Documentation, Examples, and Test Configurations for Terraform 0.12 Syntax #8950

Closed
bflad opened this issue Jun 11, 2019 · 4 comments
Assignees
Labels
breaking-change Introduces a breaking change in current functionality; usually deferred to the next major release. documentation Introduces or discusses updates to documentation.
Milestone

Comments

@bflad
Copy link
Contributor

bflad commented Jun 11, 2019

Description

We would prefer to keep Terraform configurations in documentation, examples, and tests as both Terraform 0.11 and Terraform 0.12 compatible where possible for the next few months until the community has much broader adoption of Terraform 0.12. When the time seems appropriate, we will convert all Terraform configuration to Terraform 0.12 syntax (e.g. removing string interpolations) as part of removing support for Terraform 0.11 in the provider, which will come in a major version release.

Marking this for the 3.0.0 milestone for tracking purposes, but it may not necessarily occur until a future major version after 3.0.0. Its likely this task will also get broken into separate sub-tasks as the implementation time approaches.

Definition of Done

@maryelizbeth
Copy link
Contributor

This issue will continue to aggregate the documentation and example work necessary for the deprecation of TF 0.11.

In order to optimize for a friendlier user experience, we will not prioritize merging PRs that convert examples or documentation to Terraform 0.12 syntax. Terraform 0.12 will give a warning if it detects Terraform 0.11 syntax, whereas TF 0.11 will error if TF 0.12 syntax is used within the configuration. We believe receiving a warning is a better user experience for new users, and therefore will continue using 0.11 syntax styles in the documentation, examples, and test configurations until the provider no longer supports the use of TF 0.11.

We expect to release 3.0.0 within the next quarter; for more information about functionality that will be included in 3.0.0, consult the corresponding milestone.

@ghost
Copy link

ghost commented Aug 30, 2020

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you feel this issue should be reopened, we encourage creating a new issue linking back to this one for added context. Thanks!

@ghost ghost locked and limited conversation to collaborators Aug 30, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
breaking-change Introduces a breaking change in current functionality; usually deferred to the next major release. documentation Introduces or discusses updates to documentation.
Projects
None yet
Development

No branches or pull requests

3 participants