doc/workflow/award_emoji.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# Award emoji

>**Note:**
[Introduced][1825] in GitLab 8.2.

When you're collaborating online, you get fewer opportunities for high-fives
and thumbs-ups. Emoji can be awarded to issues and merge requests, making
virtual celebrations easier.

![Award emoji](img/award_emoji_select.png)

Award emoji make it much easier to give and receive feedback without a long
comment thread. Comments that are only emoji will automatically become
award emoji.

## Sort issues and merge requests on vote count

>**Note:**
[Introduced][2871] in GitLab 8.5.

You can quickly sort issues and merge requests by the number of votes they
have received. The sort options can be found in the dropdown menu as "Most
popular" and "Least popular".

![Votes sort options](img/award_emoji_votes_sort_options.png)

---

Sort by most popular issues/merge requests.

![Votes sort by most popular](img/award_emoji_votes_most_popular.png)

---

Sort by least popular issues/merge requests.

![Votes sort by least popular](img/award_emoji_votes_least_popular.png)

---

The total number of votes is not summed up. An issue with 18 upvotes and 5
downvotes is considered more popular than an issue with 17 upvotes and no
downvotes.

## Award emoji for comments

>**Note:**
[Introduced][4291] in GitLab 8.9.

Award emoji can also be applied to individual comments when you want to
celebrate an accomplishment or agree with an opinion.

To add an award emoji, click the smile in the top right of the comment and pick
an emoji from the dropdown.

![Picking an emoji for a comment](img/award_emoji_comment_picker.png)

![An award emoji has been applied to a comment](img/award_emoji_comment_awarded.png)

If you want to remove an award emoji, just click the emoji again and the vote
will be removed.

[2871]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2781
[1825]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/1825
[4291]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/4291