Skip to content

Conversation

@kevin-loehfelm
Copy link
Contributor

What

This PR updates upgrade guides for 1.13 and 1.14 to reflect the upgrade considerations in those releases. It also make a minor syntax update to the description for version 1.15

Why

Terraform upgrade guides seems to have stopped updating after the switch to a folder-based structure. Terraform versions 1.13 and 1.14 both reflected version 1.12's upgrade guide notes


Merge Checklist

If items do not apply to your changes, add (N/A) and mark them as complete.

Pull Request

  • Description links to related pull requests or issues, if any.

Content

  • [N/A] You added redirects to content/terraform-docs-common/redirects.jsonc for moved, renamed, or deleted pages across all affected versions. Refer to Redirects for examples and guidance.
  • [N/A] Links to related content where appropriate (e.g., CLI, language, API endpoints, permissions, etc.).
  • Pages with related content are updated and link to this content when appropriate.
  • [N/A] Sidebar navigation files have been updated for added, deleted, reordered, or renamed pages.
  • [N/A] New pages have metadata (page name and description) at the top.
  • [N/A] New images are 2048 px wide. They have HashiCorp standard annotation color (#F92672) and format (rectangle with rounded corners), blurred sensitive details (e.g. credentials, usernames, user icons), and descriptive alt text in the markdown for accessibility.
  • [N/A] New code blocks have the correct syntax and line breaks to eliminate horizontal scroll bars.
  • [N/A] UI elements (button names, page names, etc.) are bolded.
  • The Vercel website preview successfully deployed.

Reviews

  • I or someone else reviewed the content for technical accuracy.
  • I or someone else reviewed the content for typos, punctuation, spelling, and grammar.

@kevin-loehfelm kevin-loehfelm requested review from a team as code owners January 2, 2026 15:12
@kevin-loehfelm kevin-loehfelm added documentation Improvements or additions to documentation and removed Terraform CE labels Jan 2, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 2, 2026

Vercel Previews Deployed

Name Status Preview Updated (UTC)
Dev Portal ✅ Ready (Inspect) Visit Preview Sat Jan 3 15:02:44 UTC 2026
Unified Docs API ✅ Ready (Inspect) Visit Preview Sat Jan 3 14:58:11 UTC 2026

@github-actions
Copy link
Contributor

github-actions bot commented Jan 2, 2026

Broken Link Checker

No broken links found! 🎉

Copy link
Contributor

@trujillo-adam trujillo-adam left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for fixing this. I added a few suggestions and questions. Approving so you can move forward after addressing them.


## Terraform Test

- External variables referenced within test files should now be accompanied by a `variable` definition block within the test file.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- External variables referenced within test files should now be accompanied by a `variable` definition block within the test file.
- External variables referenced within test files should be accompanied by a `variable` definition block within the test file.

Should or must?

Comment on lines +16 to +17
- The parallelism of Terraform operations within container runtimes may be reduced depending on the CPU bandwidth limit setting.
- Building Terraform 1.14 requires macOS Monterey or later (due to being built on Go 1.25 which imposes these requirements)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The parallelism of Terraform operations within container runtimes may be reduced depending on the CPU bandwidth limit setting.
- Building Terraform 1.14 requires macOS Monterey or later (due to being built on Go 1.25 which imposes these requirements)
- The CPU bandwidth limit setting affects Terraform's ability to perform parallel operations within container runtimes. Setting the limit too low may reduce parallelism.
- Building Terraform 1.14 requires macOS Monterey or later. This is because Terraform is built on Go 1.25, which imposes these requirements.

Can we recommend a CPU bandwidth limit?

@kevin-loehfelm kevin-loehfelm merged commit 2f47be4 into main Jan 5, 2026
15 checks passed
@kevin-loehfelm kevin-loehfelm deleted the kdl/update-terraform-upgrade-guide-versions branch January 5, 2026 15:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Terraform CE

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants