Subscriptions to issues, merge requests, and labels
Resources
PM @victorwu
Background
There has been a lot discussion about how GitLab handles subscriptions to issues, merge requests, and labels. (Primarily here: https://gitlab.com/gitlab-org/gitlab-ce/issues/12697). As well, some subscriptions are "implicit", while others are "explicit". These subscriptions result in notifications sent to people. This documents existing functionality, links to issues, and use cases that are solved and unsolved. The existing functionality and the technical challenges are described here: https://gitlab.com/gitlab-org/gitlab-ce/issues/12697#note_12607983
Problems and existing solutions (if checked)
-
As a non-participant, I start participating in an issue/merge request or someone pulls me in by @-mentioning me. I want to get notifications that other people have participated so that I can review them. - When I have participated, I become a participant according to GitLab, and participants get notifications.
-
As a participant, I don't care about the issue/merge request anymore. I don't want anymore notifications after I see the latest notification. - I click
Unsubscribe
from the email notification or the button in the issue/merge request to explicitly unsubscribe according to GitLab, and so I no longer get notifications.
- I click
-
As a participant, I want other people to see that I care and am participating in the issue/merge request. - Other people can see me in the comments and also in the participants UI.
-
As a non-participant, I want to subscribe to an issue/merge request. I want to get notifications to monitor progress. But I don't want people to know that I care. - I click
Subscribe
and am privately and explicitly subscribed to get notifications. Nobody knows that I am subscribed.
- I click
-
I want to keep track and monitor the progress of multiple related issues/merge requests. / I want to stop. - I click
Subscribe
in the labels page to explicitly subscribe to a label. I start getting notifications. - I click
Unsubscribe
to explicitly unsubscribe.
- I click
-
I have too many notifications. I want to review which issues/merge requests/labels I am subscribed to and/or participating in. And I want to stop getting those notifications from some of them that are no longer important to me. - Not solved.
-
I want to know which labels that I am currently getting notifications. Not to necessarily stop getting notifications. But to verify and validate my settings are correct. - I view the labels pages.
-
I want to know which issues/merge requests that I am currently getting notifications. Not to necessarily stop getting notifications. But to verify and validate my settings are correct. - Not solved.
-
I subscribe/unsubscribe to a label, and then subscribe/unsubscribe to an issue/merge request with that label. I want to know what is the GitLab model so set up my subscriptions correctly going forward. I want to know what are the rules and how they have been applied for a specific issue. - Not solved.
-
I want to get notifications to issues / merge requests that need to have two or more specific labels. - Not solved.