Phabricator/Help/Herald Rules

Please note that global Herald rules slow down Phabricator performance for all users (see phab:T108586) and can often be avoided by using one of these specialised methods instead:

Instead of rules like "Add project Foo when project Bar is associated", consider using subprojects and milestones.
Instead of rules like "If project tags include Foo, add me as subscriber", watch the project and potentially filter your notifications.
Instead of "Add my user project when I subscribe to a task", create a dashboard with a query panel that shows the tasks you are subscribed to.
Do not automatically assign all tasks with a certain project tag to yourself (cookie-licking).
Phabricator admins might delete inappropriate or expensive Herald rules and will inform the Herald rule author about this action.

Creating Herald rules for notifications edit

Currently restricted to members of the groups #Trusted-Contributors, #WMF-NDA, acl*Batch-Editors, and Phabricator admins.

This is how you create custom (personal) notification rules in Wikimedia Phabricator's Herald. Imagine you want to watch all the tasks that are being created:

Click Create Herald Rule.
Select Maniphest Tasks and Personal.
Give a descriptive name to the rule, i.e. "All New Tasks".
In Conditions, select all of, Is newly created?, and is True.
In Action, select every time and Send me an email.
Save Rule.

This is it. From that point, you will receive an email for every task being created. This is probably too much, though. This is how you can filter these notifications:

If you want to be notified about new tasks only in specific projects, add a New Condition, and then select Projects and include any of, adding the projects you are interested about.
If you want to be notified about new tasks only from specific users, add a New Condition, and then select Author and is any of, adding the users you are interested about.

You see where is this going. Adapting these rules you can watch the entire activity of a specific project without having to join it, you can watch certain keywords across the entire Phabricator, etc.

Global Herald rules edit

To create global Herald rules (rules unrelated to your personal account, like adding a project to a task when another project is added), create a task in Phabricator describing your request. If the request is not completed within a reasonable amount of time, contact one of the Phabricator admins (preferably User:AKlapper (WMF)).