Overview
This is not meant to replace the current notification mecanism, that is to say assignement, or "CC fields". This feature is designed to be a one time "ping" of people to inform them about something related to one issue in a follow-up comment (or any text area).
Generally speaking:
- People should be notified at the time they are mentionned
- but not after
- If people should be permanently notified, the regular notification mecanism should be used.
- If people explicitly set to not be notified on a given artifact (unsubscribe on the artifact or "stop tracker notification") they won't receive an email
- there is then a "warning feedback" displayed to the user who notified someone that this person won't be notified
- People receives the notification accordign to their permissions (on project, tracker & fields).
- If you mention @jdoe in a project she cannot access, she won't be notified.
- Notification is automatic and not configurable, everytime '@jdoe' string is matched in a supported area (see bellow), jdoe user will be notified.
Note: at XML import there is no notification of people.
Functional
Follow-up comments
At follow-up comment creation (web & REST)
- When there is a @string mention that match a username, the user is notified
- if the user should have been notified with another field, there is only 1 notif that is sent
- it can be used in combination with another notification mecanism. For instance jdoe is notified because assignee only on status changes but somebody mentions @jdoe in ca comment w/o status change => jdoe will get an email for this change.
- further follow-up comments (without mention of user) won't notify the user
At follow-up comment edition:
- Same rules apply than at creation. It means that
- given a first comment with @jdoe (that triggered a notif)
- whe this comment is updated and that the @jdoe string is still in the comment
- then a mail is sent to jdoe
- => Side Effect if @jdoe was not an actual user when the comment was created but is created later on, when the initial comment is update, @jdoe gets the notification.
Textarea fields
At text creation (web & REST):
- (creation means from an Empty text to something not empty
- When there is a @string mention that match a username, the user is notified
- if the user should have been notified with another field, there is only 1 notif that is sent
At text update (web & REST)
- Same rules apply than at "creation"
User is notified Only when the text field she is mentionned in is updated. Another way of saying it is that if @jdoe is mentionned in bug description, he won't be notified when "status" or "title" are changed or when a follow-up comment is added. How ever, as long as the string '@jdoe' is present in bug description, everytime description get changed, @jdoe will be notified.
String fields
Question: As of today, @mention is not supported in those fields ?