Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
chalin opened this issue Nov 13, 2023 · 4 comments
Assignees
Labels
admin Administration tasks blocked
Milestone

Comments

@chalin
Copy link
Collaborator

chalin commented Nov 13, 2023

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

@chalin chalin added the admin Administration tasks label Nov 13, 2023
@chalin chalin added this to the 23Q4 milestone Nov 13, 2023
@chalin
Copy link
Collaborator Author

chalin commented Nov 15, 2023

It will also allow us to set CODEOWNERS.

@chalin chalin modified the milestones: 23Q4, 24Q1 Jan 11, 2024
@emckean
Copy link
Collaborator

emckean commented Jan 26, 2024

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

@chalin
Copy link
Collaborator Author

chalin commented Feb 1, 2024

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 chalin modified the milestones: 24Q1, 24Q2 Apr 2, 2024
@emckean
Copy link
Collaborator

emckean commented May 7, 2024

testing @google/docsy-approvers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
admin Administration tasks blocked
Projects
None yet
Development

No branches or pull requests

2 participants