Skip to content

docs: terraform v1 specs and guidance#2720

Open
jaredfholgate wants to merge 3 commits into
mainfrom
docs/terraform-v1-specs-and-guidance
Open

docs: terraform v1 specs and guidance#2720
jaredfholgate wants to merge 3 commits into
mainfrom
docs/terraform-v1-specs-and-guidance

Conversation

@jaredfholgate
Copy link
Copy Markdown
Member

@jaredfholgate jaredfholgate commented May 14, 2026

Overview/Summary

Updates to specs and guidance for module owners to start getting aligned to v1 requirements

As part of this Pull Request I have

  • Read the Contribution Guide and ensured this PR is compliant with the guide
  • Checked for duplicate Pull Requests
  • Associated it with relevant GitHub Issues or ADO Work Items (Internal Only)
  • Ensured my code/branch is up-to-date with the latest changes in the main branch
  • Ensured PR tests are passing
  • Updated relevant and associated documentation (e.g. Contribution Guide, Docs etc.)

@jaredfholgate jaredfholgate requested a review from a team as a code owner May 14, 2026 08:58
@jaredfholgate jaredfholgate self-assigned this May 14, 2026
@jaredfholgate jaredfholgate marked this pull request as draft May 14, 2026 08:58
@microsoft-github-policy-service microsoft-github-policy-service Bot added the Needs: Triage 🔍 Maintainers need to triage still label May 14, 2026
@microsoft-github-policy-service
Copy link
Copy Markdown

Important

The "Needs: Triage 🔍" label must be removed once the triage process is complete!

Tip

For additional guidance on how to triage this issue/PR, see the AVM Issue Triage documentation.

…les for retry/timeouts; improve resource_types example
@jaredfholgate jaredfholgate marked this pull request as ready for review May 14, 2026 11:47
…3 AzureRM exception; standardize AzAPI examples on ~> 2.9

- Add TFRMFR1 (parent_id mandate with extension-resource exception)

- Add TFRMNFR2 (primary azapi_resource named 'this' with objective exception)

- Add TFNFR38 (resource ID validation guidance)

- Add TFNFR39 (standard file layout: terraform/variables/outputs/main/locals with optional <canonical>.<topic>.tf splits)

- TFFR3: remove pre-v1.0.0 AzureRM grandfather clause; document narrow exception for resources without an AzAPI equivalent (~> 4.0 pin, README documentation, replacement plan, TFLint exclusion)

- TFNFR21: add behavior-toggle exception permitting default = null for retry/timeouts/lock

- Standardize AzAPI provider version examples on ~> 2.9 across specs, quickstart, solution-development, VM example, and spec-kit

- Cross-reference new specs from the Terraform composition guide

- Sweep US English spelling across touched docs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Triage 🔍 Maintainers need to triage still

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants