Skip to content

Conversation

@matebarabas
Copy link
Contributor

@matebarabas matebarabas commented Nov 19, 2025

Improve documentation regarding the PR approval process for module submissions, clarifying requirements for both new modules and updates to existing ones. Add detailed guidance on who can approve PRs based on module ownership. Update flowcharts to reflect these changes.

Includes updates for both our Bicep and Terraform guidance.

image image image

@matebarabas matebarabas requested a review from a team as a code owner November 19, 2025 21:26
@matebarabas matebarabas self-assigned this Nov 19, 2025
@matebarabas matebarabas added the Type: Documentation 📄 Improvements or additions to documentation label Nov 19, 2025
@microsoft-github-policy-service microsoft-github-policy-service bot added the Needs: Triage 🔍 Maintainers need to triage still label Nov 19, 2025
click D "{{% siteparam base %}}/contributing/terraform/terraform-contribution-flow/#4-run-pre-commit-checks"
E(5 - Create a pull request to the upstream repository)
click E "{{% siteparam base %}}/contributing/terraform/terraform-contribution-flow/#5-create-a-pull-request-to-the-upstream-repository"
F(6 - Get your pull request reviewed & approved)
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
F(6 - Get your pull request reviewed & approved)
F(6 - Get your pull request reviewed, address any comments & have it approved)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I prefer not to have such long chapter title and so many words in the flow chart. In fact, I shortened it even further, given the whole point here is to get the PR approved - all requirements need to be further detailed in the actual chapter. Therefore, I also added an info-box elaborating on the point you were trying to make (i.e., all outstanding comments need to be addressed and the module owner needs to make sure the publication pipeline succeeds).
image
image

click E "{{% siteparam base %}}/contributing/bicep/bicep-contribution-flow/#5-createupdate-and-run-tests"
F(6 - Create a pull request to the upstream repository)
click F "{{% siteparam base %}}/contributing/bicep/bicep-contribution-flow/#6-create-a-pull-request-to-the-public-bicep-registry"
G(7 - Get your pull request reviewed & approved)
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
G(7 - Get your pull request reviewed & approved)
G(7 - Get your pull request reviewed, address any comments & have it approved)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

See my comment on the same above.

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 Type: Documentation 📄 Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants