docs: propagate two-tier Org Admin / Steward governance model#9
Merged
docs: propagate two-tier Org Admin / Steward governance model#9
Conversation
Splits the original single Steward role into Org Admin (org-wide) and Steward (per-project). Adds status-paused lifecycle state, Steward appointment/departure/vacancy rules, and updated Council composition. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rement - Add criterion 7: a committed Steward is required; no Steward, no adoption - Split "what the submitter commits to" into Steward path (12-month, direction ownership) and co-maintainer path (6-month) - Update "what PowerShellOrg commits to" point 2 to reflect status-paused intermediate state before archival - Update adoption workflow table: Steward → Org Admin for acknowledgment, decision, and transfer; Steward drives revival - Add steward-commitment dropdown and steward-details textarea to tool_adoption_request.yml; both new fields placed before additional-notes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Org invite, PSGallery username, key issuance, and key rotation are all Org Admin actions (previously "Steward") - Branch protection notification goes to the project's Steward - Escalation and step-down language now distinguishes co-maintainer (→ project's Steward) from Steward (→ Org Admin) - CoC report alternate contact updated to Org Admin - Add status-paused row to first-response SLA table - Add "If you are the Steward" section covering the heavier responsibilities: revival ownership, project direction, graduation proposal, and early-notice obligation Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Phase 0 intro now names the Steward as the owner of the phase: confirmed at adoption, opens the tracking issue on day one - PSGallery key creation and rotation reminder are Org Admin actions - Phase 5 status transition notification goes to the Org Admin (org-level tracking) rather than generic "Steward" - PSGallery API key rotation cadence table updated to Org Admin-driven Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add Steward column to the maintained tools table with FILL IN placeholders for each project - Add status legend including status-paused badge - Update adoption CTA to note that a committed Steward is required - Update root README governance blurb: Org Admin holds org-wide authority; Council is all active Stewards plus invited members Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… email - CONTRIBUTING.md: add status-paused row to maintainer SLA table; "Steward" → "project's Steward" in the understaffed-repo note - maintainer-onboarding.md: add status-paused row to first-response SLA table; fix CoC report address from conduct@powershellorg.example to privacy@powershell.org Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ements CODE_OF_CONDUCT.md: - Alternate contact for reports → Org Admin - Addressing and Repairing Harm section → Org Admin throughout - Private Conversation response → Org Admin - Restorative Paths discretion → Org Admin - Appeals section: writing to / reviewed by / cannot review impartially / does not vote → Org Admin throughout SECURITY.md: - Draft security advisory visibility → Org Admin (not Steward) announcements.yml: - Posting permission now names both project Stewards and the Org Admin Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
The key rotation note in the Maintainer steps block incorrectly said "the Steward will initiate rotation" — key rotation is an Org Admin action, consistent with the rest of the PSGallery key section. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- profile/README.md: Plaster Steward → James Petty; PSDepend Steward → Gilbert Sanchez - SECURITY.md: replace placeholder security email with privacy@powershell.org; remove PGP placeholder line - GOVERNANCE.md: set last-updated date to 2026/04/21 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Prose rewrapped to ~80 columns, inline links converted to reference-style, table columns aligned. No content changes. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
"The Steward retains discretion" in the Addressing and Repairing Harm section was missed in the original CoC update pass. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Keys are minted by the Org Admin or a Council member (not Org Admin exclusively); updated in maintainer-onboarding and revival-playbook - Maintainers no longer share a PSGallery username for key issuance; replaced with a note that publishing is CI-only and they do not run Invoke-psake Publish locally - Maintainer rotation responsibility changed from "you may be asked to trigger it" to "notify Org Admin or Council if the key appears expired" - CONTRIBUTING.md: Publish task comment updated to CI-only warning Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
HeyItsGilbert
commented
Apr 22, 2026
Comment on lines
+13
to
+15
| **Status legend:** ![Active][status-active] actively maintained · | ||
| ![Stable][status-stable] stable, reduced cadence · ![Paused][status-paused] | ||
| Steward vacancy in progress · ![Archived][status-archived] read-only |
Member
Author
There was a problem hiding this comment.
This line got mangled. Let's fix it.
- profile/README.md: put status legend on one line so badges don't split from their label text after formatting - CONTRIBUTING.md: replace @PowerShellOrg/maintainers ping (requires a GitHub team that doesn't exist) with "open a discussion on the relevant repository" Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
psjamesp
approved these changes
Apr 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Propagates the updated two-tier governance model from the new
GOVERNANCE.mdacross every community health file and doc in the repo. The original single-Steward role has been split into:Key changes by area:
status-pausedlifecycle stateadoption-criteria.md,tool_adoption_request.yml) — new criterion 7 (no Steward, no adoption); submitter commitment split into Steward path (12-month, direction ownership) vs co-maintainer path (6-month); adoption workflow table uses Org Admin; newsteward-commitmentdropdown andsteward-detailstextarea in the issue templatemaintainer-onboarding.md) — PSGallery key issuance/rotation → Org Admin; escalation chain is now tiered (co-maintainer → project's Steward → Org Admin); new "If you are the Steward" section; CoC report email fixed (conduct@powershellorg.example→privacy@powershell.org)revival-playbook.md) — Phase 0 explicitly names the Steward as driver and tracking-issue owner; PSGallery actions → Org Admin; Phase 5 status-transition notification → Org Adminstatus-pausedbadge, adoption CTA updated, governance blurb updatedCONTRIBUTING.md,maintainer-onboarding.md) —status-pausedrow added to both SLA tablesCODE_OF_CONDUCT.md,SECURITY.md,announcements.yml) — all enforcement, appeals, and reporting references → Org Admin; announcements template updated to name both Stewards and Org AdminPlaceholders requiring follow-up
profile/README.md(×2)<Steward: FILL IN>for Plaster and PSDepend.github/GOVERNANCE.mdfooter[DATE]docs/maintainer-onboarding.md.github/SECURITY.mdTest plan
GOVERNANCE.mdand verify it matches the intended two-tier modelthe Stewardexcluding GOVERNANCE.md and intentional project-Steward uses)<Steward: FILL IN>placeholders inprofile/README.mdbefore merging to main[DATE]in GOVERNANCE.md footer is updated before merging🤖 Generated with Claude Code