Merge branch '337977-aqualls-spam-snippet' into 'master'

Add basics for reporting snippets as spam

See merge request gitlab-org/gitlab!72810

doc/integration/akismet.md

@@ -8,7 +8,8 @@ info: To determine the technical writer assigned to the Stage/Group associated w
 
 GitLab uses [Akismet](https://akismet.com/) to prevent the creation of
 spam issues on public projects. Issues created through the web UI or the API can be submitted to
-Akismet for review.
+Akismet for review, and instance administrators can
+[mark snippets as spam](../user/snippets.md#mark-snippet-as-spam).
 
 Detected spam is rejected, and an entry is added in the **Spam Log** section of the
 Admin page.

doc/user/report_abuse.md

@@ -19,6 +19,7 @@ You can report a user through their:
 - [Profile](#reporting-abuse-through-a-users-profile)
 - [Comments](#reporting-abuse-through-a-users-comment)
 - [Issues and Merge requests](#reporting-abuse-through-a-users-issue-or-merge-request)
+- [Snippets](snippets.md#mark-snippet-as-spam)
 
 ## Reporting abuse through a user's profile
 

doc/user/snippets.md

@@ -211,6 +211,24 @@ snippet was created using the GitLab web interface the original line ending is W
 With snippets, you engage in a conversation about that piece of code,
 which can encourage user collaboration.
 
+## Mark snippet as spam **(FREE SELF)**
+
+Administrators on self-managed GitLab instances can mark snippets as spam.
+
+Prerequisites:
+
+- You must be the administrator for your instance.
+- [Akismet](../integration/akismet.md) spam protection must be enabled on the instance.
+
+To do this task:
+
+1. On the top bar, select **Menu > Projects** and find your project.
+1. On the left sidebar, select **Snippets**.
+1. Select the snippet you want to report as spam.
+1. Select **Submit as spam**.
+
+GitLab forwards the spam to Akismet.
+
 ## Troubleshooting
 
 ### Snippet limitations