Changeset View
Changeset View
Standalone View
Standalone View
src/docs/user/userguide/mail_rules.diviner
@title User Guide: Managing Phabricator Email | @title User Guide: Managing Phorge Email | ||||
@group userguide | @group userguide | ||||
How to effectively manage Phabricator email notifications. | How to effectively manage Phorge email notifications. | ||||
Overview | Overview | ||||
======== | ======== | ||||
Phabricator uses email as a major notification channel, but the amount of email | Phorge 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 | it sends can seem overwhelming if you're working on an active team. This | ||||
document discusses some strategies for managing email. | document discusses some strategies for managing email. | ||||
By far the best approach to managing mail is to **write mail rules** to | 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 | categorize mail. Essentially all modern mail clients allow you to quickly | ||||
write sophisticated rules to route, categorize, or delete email. | write sophisticated rules to route, categorize, or delete email. | ||||
Reducing Email | Reducing Email | ||||
============== | ============== | ||||
You can reduce the amount of email you receive by turning off some types of | 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 | 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 | produced by your own actions (like when you comment on a revision), and some | ||||
types of less-important notifications about events. | types of less-important notifications about events. | ||||
Mail Rules | Mail Rules | ||||
========== | ========== | ||||
The best approach to managing mail is to write mail rules. Simply writing 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 | to move mail from Differential, Maniphest and Herald to separate folders will | ||||
vastly simplify mail management. | vastly simplify mail management. | ||||
Phabricator also adds mail headers (see below) which can allow you to write | Phorge also adds mail headers (see below) which can allow you to write | ||||
more sophisticated mail rules. | more sophisticated mail rules. | ||||
Mail Headers | Mail Headers | ||||
============ | ============ | ||||
Phabricator sends various information in mail headers that can be useful in | Phorge 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 | 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 "View Raw Message" feature in your mail client. | ||||
The most useful header for routing is generally `X-Phabricator-Stamps`. This | 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 | is a list of attributes which describe the object the mail is about and the | ||||
actions which the mail informs you about. | actions which the mail informs you about. | ||||
Stamps and Gmail | Stamps and Gmail | ||||
Show All 23 Lines |
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