diff --git a/docs/dev/README.md b/docs/dev/README.md
index 2795f6b5c128..4a2f9feb3691 100644
--- a/docs/dev/README.md
+++ b/docs/dev/README.md
@@ -292,3 +292,17 @@ Release steps:
 4. Tweet
 5. Inside `rust-analyzer`, run `cargo xtask promote` -- this will create a PR to rust-lang/rust updating rust-analyzer's submodule.
    Self-approve the PR.
+
+# Permissions
+
+There are three sets of people with extra permissions:
+
+* rust-analyzer GitHub organization **admins** (which include current t-compiler leads).
+  Admins have full access to the org.
+* **review** team in the organization.
+  Reviewers have `r+` access to all of organization's repositories and publish rights on crates.io.
+  They also have direct commit access, but all changes should via bors queue.
+  It's ok to self-approve if you think you know what you are doing!
+  bors should automatically sync the permissions.
+* **triage** team in the organization.
+  This team can label and close issues.