summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/user/discussions.md10
-rw-r--r--doc/user/img/comment_type_toggle.gifbin0 -> 70796 bytes
-rw-r--r--doc/user/img/discussion_comment.pngbin0 -> 57189 bytes
3 files changed, 8 insertions, 2 deletions
diff --git a/doc/user/discussions.md b/doc/user/discussions.md
index 23a4dee94c6..2276bf1971e 100644
--- a/doc/user/discussions.md
+++ b/doc/user/discussions.md
@@ -128,6 +128,12 @@ You can now proceed to merge the merge request from the UI.
Discussions can be started on issues, commits, snippets and merge requests.
-Resolvable discussions can be added to merge request diffs, but they can also be added without a diff.
+Resolvable discussions can be added to merge request diffs, but discussions can also be added without a diff.
-To start a resolvable discussion, you can click on the `Comment` button dropdown and select `Start discussion`.
+To start a discussion, you can click on the "Comment" button toggle dropdown, select "Start discussion" and click "Start discussion" when you're ready to post the comment.
+
+![Comment type toggle](img/comment_type_toggle.gif)
+
+This will post a comment with a single thread to allow you to discuss specific comments in greater detail.
+
+![Discussion comment](img/discussion_comment.png)
diff --git a/doc/user/img/comment_type_toggle.gif b/doc/user/img/comment_type_toggle.gif
new file mode 100644
index 00000000000..b73c197b97f
--- /dev/null
+++ b/doc/user/img/comment_type_toggle.gif
Binary files differ
diff --git a/doc/user/img/discussion_comment.png b/doc/user/img/discussion_comment.png
new file mode 100644
index 00000000000..8f66d138922
--- /dev/null
+++ b/doc/user/img/discussion_comment.png
Binary files differ