Merge pull request #341 from per1234/sockpuppet-flag-instructions

Add instructions re: "flag_sockpuppets" flag to Moderator Instructions

Author: per1234

.github/workflows/check-toc-task.yml

@@ -56,6 +56,9 @@ jobs:
     if: needs.run-determination.outputs.result == 'true'
     runs-on: ubuntu-latest
 
+    env:
+      ARTIFACT_NAME: corrected-files
+
     strategy:
       fail-fast: false
 
@@ -86,4 +89,32 @@ jobs:
             MAX_DEPTH=${{ matrix.file.maxdepth }}
 
       - name: Check ToC
+        id: check-toc
         run: git diff --color --exit-code
+
+      - name: Upload corrected file to workflow artifact
+        if: failure() && steps.check-toc.outcome == 'failure'
+        uses: actions/upload-artifact@v3
+        with:
+          if-no-files-found: error
+          name: ${{ env.ARTIFACT_NAME }}
+          # Globstar prefix is to preserve folder structure in artifact.
+          # https://github.com/actions/upload-artifact/tree/v3.1.2#:~:text=path%20hierarchy%20will%20be%20preserved
+          path: "**/${{ matrix.file.name }}"
+
+      - name: Add artifact availability notice
+        if: failure() && steps.check-toc.outcome == 'failure'
+        run: |
+          echo "::notice file=${{ matrix.file.name }}::Corrected file was saved to the ${{ env.ARTIFACT_NAME }} workflow artifact"
+
+      - name: Resolution instructions
+        if: failure() && steps.check-toc.outcome == 'failure'
+        run: |
+          echo "Table of contents can be updated by running the following command from the root of the repository:"
+          echo "task markdown:toc FILE_PATH=${{ matrix.file.name }} MAX_DEPTH=${{ matrix.file.maxdepth }}"
+          echo
+          echo "- OR -"
+          echo
+          echo "Download the ${{ env.ARTIFACT_NAME }} workflow artifact and replace ${{ matrix.file.name }} with the"
+          echo "corrected file from the artifact."
+          echo "See: https://docs.github.com/actions/managing-workflow-runs/downloading-workflow-artifacts"

Taskfile.yml

@@ -20,7 +20,6 @@ tasks:
       - task: general:correct-spelling
       - task: general:format-prettier
       - task: markdown:fix
-      - task: markdown:toc
 
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-workflows-task/Taskfile.yml
   ci:validate:

content/categories/staff/moderation/_topics/moderator-instructions/1.md

@@ -23,6 +23,7 @@ For an overview of the Discourse moderation system, see the **[Discourse Moderat
     - ["Needs Approval" flag for account](#needs-approval-flag-for-account)
     - ["Needs Approval" flag for post](#needs-approval-flag-for-post)
     - [Akismet flagged post](#akismet-flagged-post)
+    - ["flag_sockpuppets" flag](#flag_sockpuppets-flag)
 - [Guides](#guides)
   - [Deal with inappropriate behavior](#deal-with-inappropriate-behavior)
   - [Delete spam](#delete-spam)
@@ -209,6 +210,37 @@ This flag is created by `@system` when a post is detected as possibly spam by [A
 
 ---
 
+<a name="sockpuppets-flag"></a>
+
+#### ["flag_sockpuppets" flag](#sockpuppets-flag)
+
+This flag is created by `@system` when a new user created a topic, and another new user at the same IP address replied. The flagged post must be reviewed by a moderator.
+
+---
+
+⚠ Legitimate users may happen to be assigned the same IP address. Be sure to carefully evaluate the flagged posts and user accounts before taking any administrative action.
+
+---
+
+<a name="if-the-post-is-benign-2"></a>
+
+##### [If the post is benign](#if-the-post-is-benign-2)
+
+1. Click the **<kbd>No, restore post</kbd>** button.
+
+<a name="if-the-post-is-malicious-2"></a>
+
+##### [If the post is malicious](#if-the-post-is-malicious-2)
+
+1. Click the **<kbd>Yes ▾</kbd>** button.
+1. From the dropdown menu, click **Suspend User**. The **"Suspend User"** dialog will open.
+1. From the **Select a timeframe** dropdown menu, select **Forever**.
+1. In the **Suspension Reason** text field, enter "malicious use of multiple accounts".
+1. From the **"What would you like to do with the associated post?"** dropdown menu, select **Delete the post**.
+1. Click the **<kbd>:no_entry_sign: Suspend</kbd>** button.
+
+---
+
 <a name="guides"></a>
 
 ## [Guides](#guides)