Ver Fonte

Document Discourse Forums and Discord Chat with links and how to join. (#12)

Document Discourse Forums and Discord Chat with links and how to join.
Jon Meow há 6 anos atrás
pai
commit
67eb4521c8
2 ficheiros alterados com 75 adições e 19 exclusões
  1. 38 6
      CONTRIBUTING.md
  2. 37 13
      docs/project/groups.md

+ 38 - 6
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.
-
-- [Google Drive](https://drive.google.com/corp/drive/folders/0ALTu5Y6kc39XUk9PVA):
-  We use this shared drive for all of our Google Docs, particularly proposal
-  drafts.
+Before using these systems, everyone must sign the CLA. They are all governed by
+the Code of Conduct.
+
+- [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
 

+ 37 - 13
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)**:
-  Grants Google Drive access.
+- [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
 
-## Core team
+### Conduct team
 
-- **[GitHub team](https://github.com/orgs/carbon-language/teams/core-team)**: A
-  contact list.
+For most purposes, the Core team should be contacted about conduct issues.
 
-## Review managers
+- [Google group](https://groups.google.com/g/carbon-lang-conduct-team):
+  Primarily a contact list.
 
-- **[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.
+### 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.