Document teams

[annevk]

The way I'd like to use teams:

• Anyone can join any team they desire. To join just let someone know or file an issue against whatwg/meta.
• Everyone tries to ensure the appropriate teams are pinged on relevant issues/pull requests
• Teams have no formal authority, though it's fine to add them as contributors to repositories for ease of collaboration. For all repositories we care about protecting master primarily. The bar for write access to other branches is much much lower.
• Teams have no responsibility either. If you ping a team and get no feedback, moving things forward responsibly is still on you.
• Creating new teams should be easy via filing an issue against whatwg/meta. Review should take some care it's not too much of a niche or overlap with existing teams.

I was thinking we'd put this in a Markdown to point folks to or maybe add it to the FAQ? Should we have a GitHub-specific FAQ?

[domenic]

The bar for write access to other branches is much much lower.

Last I checked GitHub didn't separate out "ability to push to other branches" from "ability to close (or label) issues". It's probably fine, but you can imagine bad situations where someone closes issues too aggressively.

Everything else is pretty great.

I wonder if we should try to formalize the topic: x labeling system we're using for HTML, and link teams to topics? Maybe over-ambituous and annoying to maintain though, as opposed to teams which are just automatically taken care of by GitHub for us.

Putting this in Markdown (in whatwg/meta) makes sense. And linking to it from either the FAQ or some kind of central how-to-participate page sounds reasonable. Not sure it's really an "FAQ" per say....

[annevk]

For your first concern we should maybe add "patience" and "due diligence" to Working Mode somehow.

Does GitHub have features to link teams to topics? Sounds useful... And yeah, it would be nice to have similar labels throughout all our repositories, but it'll be a bit of a hassle to maintain. Perhaps time for another bot?

[snuggs]

@annevk FWIW https://github.com/blog/1121-introducing-team-mentions