// Provide step-by-step guidance for contributors based on their contribution type. References CONTRIBUTING.md and project conventions. Triggers on: new contributor questions, 'how do I contribute', contribution guidance requests.
| name | contributor-guide |
| description | Provide step-by-step guidance for contributors based on their contribution type. References CONTRIBUTING.md and project conventions. Triggers on: new contributor questions, 'how do I contribute', contribution guidance requests. |
Ask the contributor (or infer from context) what they want to do:
| Type | Description |
|---|---|
| new-resource | Add a new Azure resource type to the provider |
| update-resource | Update an existing resource's naming constraints |
| bug-fix | Fix a bug in the provider logic |
| docs | Improve documentation |
| test | Add or improve tests |
For new-resource contributions:
grep '"name": "azurerm_<name>"' resourceDefinition.jsonazure-naming-research skill)resourceDefinition.json — add the entry in alphabetical ordergo generate && make build to regenerate code and testCHANGELOG.md under ## [Unreleased] → ### AddedREADME.md resource status table.github/PULL_REQUEST_TEMPLATE.mdFor update-resource contributions:
grep -A 15 '"name": "azurerm_<name>"' resourceDefinition.jsonresourceDefinition.jsongo generate && make buildCHANGELOG.md under ## [Unreleased] → ### ChangedFor bug-fix contributions:
make buildCHANGELOG.md under ## [Unreleased] → ### FixedFor docs contributions:
docs/ or README.mdPoint the contributor to:
.github/CONTRIBUTING.md for full guidelines.github/PULL_REQUEST_TEMPLATE.md for the PR checklistTESTING.md for test instructionsFetch the latest CAF abbreviations page from Microsoft Learn and compare against resourceDefinition.json official.slug values. Reports drift where the provider's slug differs from the official CAF slug. Triggers on: weekly scheduled audit, manual sync check.
Discover new Azure resources by fetching the latest azurerm provider resource list from the Terraform Registry and comparing against resourceDefinition.json. Identifies unsupported resources. Triggers on: weekly scheduled discovery, manual audit.
Update CHANGELOG.md with a new entry under the correct section. Parses existing structure, adds entries under [Unreleased], and assesses semver impact. Triggers on: after resource changes, bug fixes, documentation updates, or any notable project change.
Run test coverage analysis (make test_coverage), parse coverage percentage, compare against the 95% threshold, and flag regressions. Triggers on: PR checks, post-build validation, release prep.
Ensure documentation files under docs/resources/ and docs/data-sources/ reflect current resource types with accurate examples. Triggers on: after adding/updating resources, documentation audit.
Run end-to-end tests (make test_e2e or make test_e2e_quick), parse results, and produce a structured summary. Use after build succeeds to validate real Terraform workflows. Triggers on: post-build validation, PR checks, release verification.