As an email user, when I receive an email notification from phabricator I want to see at a glance what's my relation to the task and why I'm receiving the email, so that I can understand the message and what I am to do. To further help myself, I want to be able to set email filters to sort email in a fine-grained way.
Examples follow: from setting a herald notification on tasks created/assigned/cc'd to one user; and from a watched bugzilla user.
== Example phabricator email ==
```
Thread-Topic: T6296: Offer "Do not notify me of changes when the task's subscribers change unless I am reporter of the task" setting
X-Herald-Rules: <79>, <80>, <85>, <90>
X-Phabricator-Projects: <#wikimedia>, <#maniphest>
X-Phabricator-To: <PHID-USER-vg42yoljioxdv5iac3py>
X-Phabricator-Cc: <PHID-USER-p2axfzcmoluit7llpzt2>
X-Phabricator-Cc: <PHID-USER-vg42yoljioxdv5iac3py>
X-Phabricator-Cc: <PHID-USER-7m5vr3h2wgau5fjkabs3>
X-Phabricator-Cc: <PHID-USER-wnf4fubsvi6l3gx4i7z6>
In-Reply-To: <maniphest-task-PHID-TASK-mlmzi5hzq6ohkrkzxs23@phabricator.com>
References: <maniphest-task-PHID-TASK-mlmzi5hzq6ohkrkzxs23@phabricator.com>
Thread-Index: NzdjMjQxMTIwYmEwOGRjZjgxYmUwMmY3NzA4IFQ700M=
X-Phabricator-Sent-This-Message: Yes
X-Mail-Transport-Agent: MetaMTA
X-Auto-Response-Suppress: All
X-Phabricator-Mail-Tags: <maniphest-column>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="utf-8"
X-SES-Outgoing: 2014.10.13-54.240.8.86
Feedback-ID: us-east-1.ImFrbGFwcGVyIChBbmRyZSBLbGFwcGVyKSIgPG5vcmVwbHlAcGhhYnJpY2F0b3IuY29tPg==:AmazonSES
aklapper moved this task to Details on the Wikimedia workboard.
TASK DETAIL
https://secure.phabricator.com/T6296
REPLY HANDLER ACTIONS
Reply to comment or attach files, or !close, !claim, !unsubscribe or !assign <username>.
To: aklapper
Cc: qgil, aklapper, jeremyb, nemobis
```
== Example bugzilla email ==
```
Subject: [Bug 64440] Language setting keeps resetting itself at kk:
Date: Tue, 16 Sep 2014 03:48:49 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: CC $person-email-redacted
X-Bugzilla-Product: MediaWiki
X-Bugzilla-Component: Language converter
X-Bugzilla-Version: unspecified
X-Bugzilla-Keywords:
X-Bugzilla-Severity: normal
X-Bugzilla-Who: at.light@...
X-Bugzilla-Status: NEW
X-Bugzilla-Priority: High
X-Bugzilla-Assigned-To: wikibugs-l@lists.wikimedia.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags:
X-Bugzilla-Changed-Fields: cc
Message-ID: <bug-64440-7541-QXvrd30vfZ@https.bugzilla.wikimedia.org/>
In-Reply-To: <bug-64440-7541@https.bugzilla.wikimedia.org/>
References: <bug-64440-7541@https.bugzilla.wikimedia.org/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: 7bit
X-Bugzilla-URL: https://bugzilla.wikimedia.org/
Auto-Submitted: auto-generated
MIME-Version: 1.0
https://bugzilla.wikimedia.org/show_bug.cgi?id=64440
This, that and the other (TTO) <at.light@...> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |at.light@...
--- Comment #9 from This, that and the other (TTO) <at.light@...> ---
[1] looks suspicious. No other language converters set $wgLanguageCode...
[1]
http://git.wikimedia.org/blob/mediawiki%2Fcore.git/38d7a2abf1a94b3f637f49177a5bc7b993087229/languages%2Fclasses%2FLanguageKk.php#L302
--
You are receiving this mail because:
You are on the CC list for the bug.
You are watching someone on the CC list of the bug.
```
== Example usage ==
a) I look up the notification footer most of the times: e.g. if a question is asked on a report I created I'm more likely to be expected to address it; if I voted the report this reminds me I care about it; if I'm just cc'd it might be anything.
b) I have email filter(s) depending on X-Bugzilla-Who, X-Bugzilla-Reason, X-Bugzilla-Watch-Reason.