about summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/REVIEWS.md19
1 files changed, 16 insertions, 3 deletions
diff --git a/docs/REVIEWS.md b/docs/REVIEWS.md
index 930a15c8e74b..63d6b2c52460 100644
--- a/docs/REVIEWS.md
+++ b/docs/REVIEWS.md
@@ -138,9 +138,22 @@ instance, follow these instructions:
 5. Submit the commit via email (see below).
 
 ## Submitting changes via email
-
-You can submit a patch via email to `depot@tvl.su` and it will be
-added to Gerrit by a contributor.
+Please keep in mind this process is more complicated and requires more work from
+both sides:
+
+ - Someone needs to relay potential comments from Gerrit to you, you won't get
+   emails from Gerrit.
+ - Uploading new revisions needs to be done by the person sending it to Gerrit
+   on your behalf.
+ - If you decide to get a Gerrit account later on, existing CLs need to be
+   abandoned and recreated (as CLs can't change Owner).
+   This causing earlier reviews do be more disconnected, causing more churn.
+
+We provide local accounts and do SSO with various third-parties, so getting the
+account should usually be low-friction.
+
+If you still decide differently, you can submit a patch via email to
+`depot@tvl.su` and it will be added to Gerrit by a contributor.
 
 Create an appropriate commit locally and send it us using either of these options: