Skip to content

HVD: Update control workspaces content - #3085

Draft
danbr-ibm wants to merge 1 commit into
mainfrom
migrate-hvd-pr-402-control-workspaces
Draft

HVD: Update control workspaces content#3085
danbr-ibm wants to merge 1 commit into
mainfrom
migrate-hvd-pr-402-control-workspaces

Conversation

@danbr-ibm

@danbr-ibm danbr-ibm commented Aug 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

Rewrite the control workspaces section in the HVD Terraform Operating Guide to reflect updated terminology and guidance agreed between CDL, PS, and SA. The work was delayed by module publication blockers (doormat/passport IT permissions) and gaps in implementation understanding. The agreed terminology and hierarchy is now fully understood and the supporting module has been published.

Source PR being migrated: https://github.com/hashicorp/hvd-docs/pull/402

Changes

Updated files:

  • content/validated-designs/docs/docs/terraform/administration-guide/introduction.mdx
  • content/validated-designs/docs/docs/terraform/administration-guide/organizing-resources.mdx
  • content/validated-designs/docs/docs/terraform/user-guide/iac-and-cloud-provisioning.mdx
  • content/validated-designs/img/terraform/operating-guides/adoption/hvd-terraform-oga-control-workspace-hierarchy.svg

Main guidance themes migrated:

  • terminology updates from business-unit language to app-team language
  • Terraform Landing Zone (TLZ) framing and hierarchy
  • revised control workspace guidance spanning Platform Management, Control, and App workspaces
  • new hierarchy diagram asset

Open items for human attention

ℹ️ Needs-human: Confirm whether "the landing zone provisioning workflow" should remain general in the introductory sentence or be made explicitly "the Terraform Landing Zone provisioning workflow".
ℹ️ Needs-human: Consider whether the control workspace bullet should add a cross-reference clarifying that the provider guidance applies equally to HCP Terraform and Terraform Enterprise.
ℹ️ Needs-human: Module links currently point to GitHub source for terraform-tfe-platform-management; update them to the registry URL once published.

Notes

This is a draft PR created as part of the HVD migration from hashicorp/hvd-docs into hashicorp/web-unified-docs. The content is being moved as-is in draft form so any follow-up review and cleanup can happen in the correct repository.

Move the draft control-workspace and Terraform Landing Zone updates from the old hvd-docs PR into web-unified-docs so the validated design work continues in the repository that now owns it.

This preserves the terminology changes, the rewritten TLZ guidance, and the new hierarchy diagram without trying to resolve the remaining draft-stage review items during migration.

Keeping the transfer minimal makes the migrated PR easy to compare against the source draft and keeps any follow-up review in the correct repository.
@danbr-ibm danbr-ibm added AI used Warning: human SME checks required Validated Designs labels Aug 11, 2026
@github-actions

github-actions Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Vercel Previews Deployed

Name Status Preview Updated (UTC)
Dev Portal ✅ Ready (Inspect) Visit Preview Tue Aug 11 15:46:28 UTC 2026
Unified Docs API ✅ Ready (Inspect) Visit Preview Tue Aug 11 15:40:58 UTC 2026

@github-actions

Copy link
Copy Markdown
Contributor

Broken Link Checker

This PR contains broken links, but won't be blocked. Use this report to improve content quality:

Quick Actions

  • Internal links (HashiCorp sites): Please fix these - they impact user experience
  • External links: Consider if these are essential or can be updated/removed
  • Temporary issues: External sites may recover - check again before merging

Need Help?


Internal Links

Full Github Actions output

External Links

Summary

Status Count
🔍 Total 25
✅ Successful 4
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 21
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 0

Full Github Actions output

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI used Warning: human SME checks required Validated Designs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant