From 0f5fe3c6ad358cedc18bc383446738f23e03f29c Mon Sep 17 00:00:00 2001
From: Abraham Williams <abraham@github.com>
Date: Tue, 7 Jan 2025 12:53:29 -0600
Subject: [PATCH] Document gist comment moderation (#53772)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>
---
 .../index.md                                  |  1 +
 .../moderating-gist-comments.md               | 24 +++++++++++++++++++
 data/variables/gists.yml                      |  3 +++
 3 files changed, 28 insertions(+)
 create mode 100644 content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md

diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md
index 6ae903404090..248b788a8cab 100644
--- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md
+++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md
@@ -14,5 +14,6 @@ children:
   - /creating-gists
   - /forking-and-cloning-gists
   - /saving-gists-with-stars
+  - /moderating-gist-comments
 shortTitle: Share content with gists
 ---
diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md
new file mode 100644
index 000000000000..1e2a3df5c860
--- /dev/null
+++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md
@@ -0,0 +1,24 @@
+---
+title: Moderating gist comments
+intro: 'You can moderate comments on gists by turning them off or deleting unwanted entries.'
+versions:
+  fpt: '*'
+  ghes: '>=3.17'
+  ghec: '*'
+---
+## Disabling comments
+
+You can hide existing comments and prevent new comments from being added to a gist by disabling comments for the gist. You can re-enable comments at any time. This will make existing comments visible.
+
+1. Navigate to {% data variables.gists.gist_user %} and select the gist you want to moderate.
+1. In the top right corner, select **{% octicon "pencil" aria-hidden="true" %} Edit**.
+1. In the top right corner, select **{% octicon "comment" aria-hidden="true" %} Disable comments**.
+
+## Deleting comments
+
+You can delete a comment on a gist if you are the author of the gist or the author of the comment.
+
+1. Navigate to {% data variables.gists.gist_user %} and select the gist you want to moderate.
+1. On the upper-right corner of the comment box, select **{% octicon "kebab-horizontal" aria-label="Open dropdown menu" %}**.
+1. From the dropdown menu select **Delete**.
+1. Select **OK** to confirm.
diff --git a/data/variables/gists.yml b/data/variables/gists.yml
index 304c4a1cfaae..ab7796a143ce 100644
--- a/data/variables/gists.yml
+++ b/data/variables/gists.yml
@@ -12,3 +12,6 @@ gist_starred: >-
 
 gist_user_starred: >-
   {% ifversion fpt or ghec %}`https://gist.github.com/YOUR_USERNAME/starred`{% else %}`http(s)://[hostname]/gist/YOUR_USERNAME/starred` or `http(s)://gist.[hostname]/YOUR_USERNAME/starred` if subdomains are enabled{% endif %}
+
+gist_user: >-
+  {% ifversion fpt or ghec %}`https://gist.github.com/YOUR_USERNAME`{% else %}`http(s)://[hostname]/gist/YOUR_USERNAME` or `http(s)://gist.[hostname]/YOUR_USERNAME` if subdomains are enabled{% endif %}