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
Binary files /dev/null and b/doc/user/img/comment_type_toggle.gif differ
diff --git a/doc/user/img/discussion_comment.png b/doc/user/img/discussion_comment.png
new file mode 100644
index 00000000000..8f66d138922
Binary files /dev/null and b/doc/user/img/discussion_comment.png differ