From cd7ba6cd7bf94e690802dc0a3a773c48e19c6a3f Mon Sep 17 00:00:00 2001 From: epriestley Date: Wed, 14 Mar 2018 13:05:49 -0700 Subject: [PATCH] Improve documentation around using Mail stamps with Gmail Summary: Ref T13069. See PHI54. Some of this behavior isn't entirely obvious, so give users a heads up in the documentation to help warn them about what is to come. Test Plan: Read documentation. Maniphest Tasks: T13069 Differential Revision: https://secure.phabricator.com/D19227 --- src/docs/user/userguide/mail_rules.diviner | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) 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 @@ -43,6 +43,27 @@ 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.