Overview
The goal of the feature is to bring the, now ubiquitous, (email) notification when using @username
in a tracker follow-up comment. This is a one time notification, the user who's being notified won't receive updates for future notifications.
Acceptance criteria
Add a follow-up comment
- When a follow-up comment contains a user reference in the form
@username
- Then Tuleap sends an email to that user with the tracker notification according to user permissions
An info text helper is added near the "follow-up" section of the mass change zone to inform that people mentioned here triggers notifications.
Mockup needed
Update of text / string
- When a text or a string field contains a user reference in the form
@username
- Then there is no notification of the mentioned user
Note : in order to avoid confusions about the expected behaviour, the @... autocompleter is removed from Text field edition in Artifact View and Modal.
Update of an existing comment
- When the new content of the follow-up comment contains a user reference in the form
@username
- Then Tuleap sends an email to that user with the tracker notification according to user permissions
Mass change
- When the new comment is added with mass-change
- Then Tuleap sends an email to that user with the tracker notification according to user permissions, even if "send notification" checkbox is unchecked
- We consider that if the user who does the mass change include a follow-up, then there is an intend to notify this use
An info text helper is added near the "follow-up" section of the mass change zone to inform, even if «send notifications» is not checked.
Mockup needed
Mentioned user chose "No notification for the tracker"
- When a follow-up comment contains a user reference in the form
@username
- Then there is no notification of the mentioned user
Mentioned user Unsubscribed to the artifact notification
- When a follow-up comment contains a user reference in the form
@username
- Then there is no notification of the mentioned user
Tracker is configured with "No notifications at all"
- When a follow-up comment contains a user reference in the form
@username
- Then there is no notification of the mentioned user
- And there is a warning to the author the change telling them that the tracker doesn't send notifications (this is the only situation where there is a non delivery warning)
General note: the author of the comment cannot be informed about the success or failure of the notification. We could imagine that we can detect that user chose to unsubscribe to an artifact and inform author about that. However, if the email cannot be sent because of configuration issue or issue with email infrastructure or because the recipient mailbox is full, we won't be able to detect it. If we sometime inform them that mail cannot be sent it could assume that no warning/error message means that user got notified but that's not 100% accurate.