docsy icon indicating copy to clipboard operation
docsy copied to clipboard

Define teams for `docsy-maintainers`, `docsy-approvers`, and the steering committee

Open chalin opened this issue 1 year ago • 4 comments

As a step towards formalizing Docsy team roles (and their associated responsibilities and access rights), I'd like to suggest that we create the following GH teams:

  • Docsy maintainers,docsy-maintainers
  • Docsy approvers, which includes maintainers as a team member - docsy-approvers
  • Docsy steering committee:
    • I think that we might want to adopt the term "technical steering committee" (TSC) rather than "project steering committee" (PSC) as introduced in the Hello Docsy! blog. Just a thought.
    • Might "governance committee" be better?
    • Depending on the answers to the questions above, we'd have possibly, one of the following. I'm trying to find a short but meaningful name (even if it isn't PSC or TSC):
      • docsy-steering feels like there's a word missing; docsy-steerers (wow, I didn't think that was a word, but it is!); or maybe docsy-leads
      • docsy-steering-committee; or the shorter docsy-sc but that seems a bit cryptic; as does docsy-tsc
      • docsy-governance-committee; or docsy-gc, which feels a little less cryptic to me, maybe because I'm used to seeing that abbreviation used at the CNCF?

AFAIK, teams need to be defined at the org level. Can you look into this @emckean?

Edit: waiting on

  • #1992

chalin avatar Nov 13 '23 11:11 chalin

It will also allow us to set CODEOWNERS.

chalin avatar Nov 15 '23 14:11 chalin

These teams have been created; can you see them under Collaborators and Teams?

emckean avatar Jan 26 '24 20:01 emckean

No, I can't see the teams and they don't seem to be accessible from here -- that is, in issue comments. Normally, I should be able to use @ completion to find teams, but that isn't showing any teams starting with docsy.

chalin avatar Feb 01 '24 10:02 chalin

testing @google/docsy-approvers

emckean avatar May 07 '24 17:05 emckean