Skip to content

Conversation

@BrianMMcClain
Copy link
Contributor

@BrianMMcClain BrianMMcClain commented Dec 2, 2025

What

Add documentation context in the left-nav of the Intro to Terraform section of the docs.

Why

Investigation shows users often visit the Intro to Terraform documentation from the main Terraform landing page, but rarely make it out to the documentation unless linked in the individual page. This change adds the similar docs sections to the left-nav in the Intro to Terraform docs to help users find docs easier.


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

  • 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.
  • 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.
  • Sidebar navigation files have been updated for added, deleted, reordered, or renamed pages.
  • New pages have metadata (page name and description) at the top.
  • 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.
  • New code blocks have the correct syntax and line breaks to eliminate horizontal scroll bars.
  • 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.

@BrianMMcClain BrianMMcClain requested review from a team as code owners December 2, 2025 21:53
@BrianMMcClain BrianMMcClain changed the title Terraform Docs Add documentation context to Intro to Terraform docs Dec 2, 2025
@BrianMMcClain BrianMMcClain marked this pull request as draft December 2, 2025 21:53
@github-actions
Copy link
Contributor

github-actions bot commented Dec 2, 2025

Vercel Previews Deployed

Name Status Preview Updated (UTC)
Dev Portal ✅ Ready (Inspect) Visit Preview Thu Dec 4 19:40:06 UTC 2025
Unified Docs API ✅ Ready (Inspect) Visit Preview Thu Dec 4 19:35:15 UTC 2025

@github-actions
Copy link
Contributor

github-actions bot commented Dec 2, 2025

Broken Link Checker

No broken links found! 🎉

Copy link
Contributor

@rkoron007 rkoron007 left a comment

Choose a reason for hiding this comment

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

Looks good to me! Left a comment that you'll need to add the "Phases" articles to the versions missing them, but besides that this should be good to go!

@BrianMMcClain BrianMMcClain marked this pull request as ready for review December 4, 2025 19:17
@BrianMMcClain BrianMMcClain enabled auto-merge (squash) December 4, 2025 19:19
@BrianMMcClain BrianMMcClain merged commit f884385 into main Dec 4, 2025
15 checks passed
@BrianMMcClain BrianMMcClain deleted the intro-nav-update branch December 4, 2025 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants