diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0f083b8f25c0..67accc2dd79f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -99,12 +99,44 @@ take ownership of providing a CLA. We use a few systems for collaboration which contributors should be aware of. Membership is currently invite-only. -- [GitHub](https://github.com/orgs/carbon-language): We use the - "carbon-language" organization for our repositories. +Before using these systems, everyone must sign the CLA. They are all governed by +the Code of Conduct. -- [Google Drive](https://drive.google.com/corp/drive/folders/0ALTu5Y6kc39XUk9PVA): - We use this shared drive for all of our Google Docs, particularly proposal - drafts. +- [The GitHub carbon-language organization](https://github.com/orgs/carbon-language) + is used for our repositories. **To join:** + +1. Ask [an admin](docs/project/groups.md#admins) to send an invite, providing + your GitHub account. +2. Check your email to accept the invite, or try the standard + [accept link](https://github.com/orgs/carbon-language/invitation?via_email=1) + if you don't see the email. + +- [Discourse Forums](https://forums.carbon-lang.dev) are used for long-form + discussions. **To join:** + + 1. Go to [the forums](https://forums.carbon-lang.dev) and register your + GitHub account. + - You will be able to choose which GitHub email you want the forums to + send email to. + 2. [An admin](docs/project/groups.md#admins) will need to approve your + registration. + +- [Discord Chat](https://discord.com/app) is used for short-form chats. **To + join:** + + 1. Ask [an admin](docs/project/groups.md#admins) for an invite link. + - Please do not re-share the invite links: they're our only way to + restrict access. + 2. You will be prompted with the Code of Conduct. After reading it, click the + check mark reaction icon at the bottom. + +- [A shared Google Drive](https://drive.google.com/corp/drive/folders/0ALTu5Y6kc39XUk9PVA) + is used for all of our Google Docs, particularly proposal drafts. **To join:** + 1. Ask [an admin](docs/project/groups.md#admins) to invite you, providing + your Google account email. + 2. The admin will add you to the + [Google Group](https://groups.google.com/g/carbon-lang-contributors) used + for access. ## Contribution guidelines and standards diff --git a/docs/project/groups.md b/docs/project/groups.md index 8665ec19e5a5..87b78e0f67de 100644 --- a/docs/project/groups.md +++ b/docs/project/groups.md @@ -5,26 +5,50 @@ tracking. We use a mix of: -- **GitHub teams** to assist contacting key contributor groups on GitHub. +- Groups to assist contacting key contributors on appropriate systems: + - **GitHub teams** + - **Discourse Forums groups** + - **Discord Chat roles** - **Google groups**, usually as Google Drive ACLs. We generally won't use these as contact lists, unless specifically mentioned. Please prefer Discourse Forums. ## All contributors -- **[GitHub organization](https://github.com/orgs/carbon-language/people)**: - Grants GitHub access. -- **[Google group](https://groups.google.com/g/carbon-lang-contributors)**: +- [GitHub organization](https://github.com/orgs/carbon-language/people) +- [Discourse Forums account](https://forums.carbon-lang.dev) +- [Discord Chat access](https://discord.com/app) +- [Google group](https://groups.google.com/g/carbon-lang-contributors): Grants + Google Drive access. + +## Team-specific access + +Any team-specific access will typically be managed by a team owner or admin, +when somebody joins the respective team. + +### Admins + +- [GitHub owners](https://github.com/orgs/carbon-language/people?query=role%3Aowner) +- [Discourse Forums group](https://forums.carbon-lang.dev/g/admins) +- Discord Chat role: admin + +### Conduct team + +For most purposes, the Core team should be contacted about conduct issues. + +- [Google group](https://groups.google.com/g/carbon-lang-conduct-team): + Primarily a contact list. + +### Core team + +- [GitHub team](https://github.com/orgs/carbon-language/teams/core-team) +- [Discourse Forums group](https://forums.carbon-lang.dev/g/core_team) +- Discord Chat role: core-team + +### Review managers + +- [GitHub team](https://github.com/orgs/carbon-language/teams/review-managers) +- [Discourse Forums group](https://forums.carbon-lang.dev/g/review_managers) +- Discord Chat role: review-managers +- [Google group](https://groups.google.com/g/carbon-lang-review-managers): Grants Google Drive access. - -## Core team - -- **[GitHub team](https://github.com/orgs/carbon-language/teams/core-team)**: A - contact list. - -## Review managers - -- **[GitHub team](https://github.com/orgs/carbon-language/teams/review-managers)**: - A contact list. -- **[Google group](https://groups.google.com/g/carbon-lang-review-managers)**: - Grants team-specific Google Drive privileges.