Page MenuHomePhorge
Files F2983598

No OneTemporary
Actions

View Options

diff --git a/src/docs/user/userguide/mail_rules.diviner b/src/docs/user/userguide/mail_rules.diviner
index 61bc3210e9..cdbbf1919d 100644
--- a/src/docs/user/userguide/mail_rules.diviner
+++ b/src/docs/user/userguide/mail_rules.diviner
@@ -1,48 +1,69 @@
@title User Guide: Managing Phabricator Email
@group userguide
How to effectively manage Phabricator email notifications.
Overview
========
Phabricator uses email as a major notification channel, but the amount of email
it sends can seem overwhelming if you're working on an active team. This
document discusses some strategies for managing email.
By far the best approach to managing mail is to **write mail rules** to
categorize mail. Essentially all modern mail clients allow you to quickly
write sophisticated rules to route, categorize, or delete email.
Reducing Email
==============
You can reduce the amount of email you receive by turning off some types of
email in {nav Settings > Email Preferences}. For example, you can turn off email
produced by your own actions (like when you comment on a revision), and some
types of less-important notifications about events.
Mail Rules
==========
The best approach to managing mail is to write mail rules. Simply writing rules
to move mail from Differential, Maniphest and Herald to separate folders will
vastly simplify mail management.
Phabricator also adds mail headers (see below) which can allow you to write
more sophisticated mail rules.
Mail Headers
============
Phabricator sends various information in mail headers that can be useful in
crafting rules to route and manage mail. To see a full list of headers, use
the "View Raw Message" feature in your mail client.
The most useful header for routing is generally `X-Phabricator-Stamps`. This
is a list of attributes which describe the object the mail is about and the
actions which the mail informs you about.
+Stamps and Gmail
+================
+
If you use a client which can not perform header matching (like Gmail), you can
change the {nav Settings > Email Format > Send Stamps} setting to include the
stamps in the mail body and then match them with body rules.
+
+When writing filter rules against mail stamps in Gmail, you should quote any
+filters you want to apply. For example, specify rules like this, with quotes:
+
+> "author(@alice)"
+
+Note that Gmail will ignore some symbols when matching mail against filtering
+rules, so you can get false positives if the body of the message includes text
+like `author alice` (the same words in the same order, without the special
+symbols).
+
+You'll also get false positives if the message body includes the text of a
+mail stamp explicitly in a normal text field like a summary, description, or
+comment.
+
+There's no way to avoid these false positives other than using a different
+client with support for more powerful filtering rules, but these false
+positives should normally be uncommon.

File Metadata

Mime Type
text/x-diff
Expires
Thu, Feb 20, 19:08 (2 d, 16 h ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1164114
Default Alt Text
(2 KB)

Event Timeline

Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0