瀏覽代碼

Update README/CONTRIBUTING for go-public access rules (#1390)

Jon Ross-Perkins 3 年之前
父節點
當前提交
6c291ba00d
共有 2 個文件被更改,包括 33 次插入33 次删除
  1. 13 30
      CONTRIBUTING.md
  2. 20 3
      README.md

+ 13 - 30
CONTRIBUTING.md

@@ -129,50 +129,33 @@ take ownership of providing a CLA.
 ### Collaboration systems
 
 We use a few systems for collaboration which contributors should be aware of.
-Membership is currently invite-only.
 
 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.
-
--   [Discord](https://discord.com/app) is used for chat. **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.
-
+-   [The GitHub carbon-language organization](https://github.com/carbon-language)
+    is used for our repositories.
+-   [Discord](https://discord.gg/ZjVdShJDAs) is used for chat.
+-   [A shared Google Drive](https://drive.google.com/corp/drive/folders/18AFPsUWNXfAloZx0tRHTsrdCWUlJLpeW)
+    is used for all of our Google Docs, particularly proposal drafts.
 -   [Google Calendar](https://calendar.google.com/calendar/embed?src=c_07td7k4qjq0ssb4gdl6bmbnkik%40group.calendar.google.com)
     is used for meeting invites and project reminders. Contributors may add
     calendar entries for meetings added to discuss details. Standard entries
     are:
 
     -   The
-        [weekly sync](https://docs.google.com/document/d/1K_5uig1HHMsfEl-6eSMjM1qjwX-7PsbkBuRp36knxlQ/edit),
+        [weekly sync](https://docs.google.com/document/d/1pYq5MssjOi8c-wBJaHEDcsVMirFeC3iv2uFUOwsI3-M/edit),
         where everyone is welcome.
-    -   [Open discussions](https://docs.google.com/document/d/1QCdKQ33rki-kCDrxi8UHy3a36dtW0WdMqpUzluGSrz4/edit?resourcekey=0-bZmNUiueOiH_sysJNqnT9A)
+    -   [Open discussions](https://docs.google.com/document/d/1NnFKOUNh_BCbVD29JiNqQ0JzC5VfE6YUq6CfKqFkouQ/edit),
         which are unstructured meeting slots used for discussing proposals,
         tooling, and other Carbon topics based on who attends.
 
+Note that commenting on Google Docs and some label changes in GitHub will
+require some contributor access: make sure you've
+[signed the CLA](#contributor-license-agreements-clas) then ask for access on
+[#getting-started](https://discord.com/channels/655572317891461132/655577725347561492)
+on Discord.
+
 ### Contribution tools
 
 Please see our [contribution tool](/docs/project/contribution_tools.md)

+ 20 - 3
README.md

@@ -259,9 +259,26 @@ semantics onto C++ such as Rust-inspired
 You can get started playing with Carbon by checking out the codebase and using
 the Carbon explorer:
 
+```shell
+# Install bazelisk using Homebrew.
+$ brew install bazelisk
+
+# Install Clang/LLVM using Homebrew.
+# Many Clang/LLVM releases aren't built with options we rely on.
+$ brew install llvm
+$ export PATH="$(brew --prefix llvm)/bin:${PATH}"
+
+# Download Carbon's code.
+$ git clone https://github.com/carbon-language/carbon-lang
+$ cd carbon-lang
+
+# Build and run the explorer.
+$ bazel run //explorer -- ./explorer/testdata/basic_syntax/print.carbon
 ```
-TODO: write exact steps to check out, build, and run the explorer on sample Carbon code
-```
+
+These instructions assume [Homebrew](https://brew.sh/); see our
+[contribution tools documentation](/docs/project/contribution_tools.md) for more
+extensive tooling instructions.
 
 Learn more about the Carbon project:
 
@@ -282,4 +299,4 @@ contribute.
 -   See our [code of conduct](CODE_OF_CONDUCT.md) and
     [contributing guidelines](CONTRIBUTING.md) for information about the Carbon
     development community.
--   We discuss Carbon on Discord; a public link will be forthcoming.
+-   We discuss Carbon on [Discord](https://discord.gg/ZjVdShJDAs).