Skip to content

Conversation

@matebarabas
Copy link
Contributor

@matebarabas matebarabas commented Sep 16, 2025

Overview/Summary

This pull request updates documentation to simplify and clarify the management of GitHub teams for module ownership, focusing on removing references to "contributors" teams and standardizing guidance for "owners" teams only. The changes affect Bicep and Terraform documentation, as well as related process and specification files.

Key documentation and process updates:

GitHub Team Management and Ownership Process

  • Updated instructions to require only the creation and management of -owners- GitHub teams for modules, removing references to -contributors- teams throughout the owner contribution flow and triage documentation. This includes changes to team naming conventions, parent team assignments, and steps for transferring or orphaning module ownership. [1] [2] [3] [4] [5]

Module Index and Reference Documentation

  • Updated all Bicep module index pages (bicep-resource-modules.md, bicep-pattern-modules.md, bicep-utility-modules.md) to remove references to contributor teams and focus on owner teams in section titles, notices, and expandable content. [1] [2] [3]
  • Removed the "For Module Owners & Contributors" sections and related details from all Terraform module index pages to align with the new owner-only team approach. [1] [2] [3]
  • Updated cross-references in shared specification files to point to the new owner-centric section anchors in module index documentation.

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.)

@microsoft-github-policy-service microsoft-github-policy-service bot added the Needs: Triage 🔍 Maintainers need to triage still label Sep 16, 2025
@matebarabas matebarabas self-assigned this Sep 16, 2025
@matebarabas matebarabas added Type: Documentation 📄 Improvements or additions to documentation and removed Needs: Triage 🔍 Maintainers need to triage still labels Sep 16, 2025
Copy link
Contributor Author

@matebarabas matebarabas left a comment

Choose a reason for hiding this comment

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

@matt-FFFFFF, can you please provide a blurb explaining how the new rights management approach and group assignment looks like for TF in those two sections where I tagged you? Thanks!

matebarabas and others added 3 commits September 23, 2025 08:58
…SNFR20.md

Co-authored-by: Matt White <16320656+matt-FFFFFF@users.noreply.github.com>
…SNFR20.md

Co-authored-by: Matt White <16320656+matt-FFFFFF@users.noreply.github.com>
@matebarabas matebarabas marked this pull request as ready for review September 23, 2025 16:14
@matebarabas matebarabas requested a review from a team as a code owner September 23, 2025 16:14
@matebarabas matebarabas enabled auto-merge (squash) September 23, 2025 16:18
Copy link
Contributor

@nirantareamit nirantareamit left a comment

Choose a reason for hiding this comment

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

checked each change and did not notice any problem.

@matebarabas matebarabas merged commit f1783e2 into main Sep 23, 2025
7 checks passed
@matebarabas matebarabas deleted the feat/matebarabas/contributor-teams-retirement branch September 23, 2025 17:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Type: Documentation 📄 Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants