Adds docs for vulnerability dismissal reasons

3 files changed, 10 insertions, 0 deletions

diff --git a/doc/user/application_security/img/dismissed_info.png b/doc/user/application_security/img/dismissed_info.png
new file mode 100644
index 00000000000..64d5cf26ed2
--- /dev/null
+++ b/doc/user/application_security/img/dismissed_info.png
diff --git a/doc/user/application_security/img/interactive_reports.png b/doc/user/application_security/img/interactive_reports.png
index 9f9812dc69d..373b39104db 100644
--- a/doc/user/application_security/img/interactive_reports.png
+++ b/doc/user/application_security/img/interactive_reports.png
diff --git a/doc/user/application_security/index.md b/doc/user/application_security/index.md
index 64e72fab198..d69cc22c1e7 100644
--- a/doc/user/application_security/index.md
+++ b/doc/user/application_security/index.md
@@ -47,6 +47,16 @@ You can dismiss vulnerabilities by clicking the **Dismiss vulnerability** button
 This will dismiss the vulnerability and re-render it to reflect its dismissed state.
 If you wish to undo this dismissal, you can click the **Undo dismiss** button.
 
+#### Adding a dismissal reason
+
+> Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing) 12.0.
+
+When dismissing a vulnerability it's often helpful to provide a reason for doing so.
+If you press the comment button next to **Dismiss vulnerability** in the modal a text box will appear allowing you to add a comment with your dismissal.
+This comment can not currently be edited or removed, but future versions will add this functionality.
+
+![Dismissed vulnerability comment](img/dismissed_info.png)
+
 ### Creating an issue for a vulnerability
 
 You can create an issue for a vulnerability by selecting the **Create issue**