Skip to content

Commit 04455e2

Browse files
authored
Tweaks for managing disruptive comments (#17280)
1 parent 6bb2c38 commit 04455e2

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

content/communities/moderating-comments-and-conversations/managing-disruptive-comments.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,12 +50,14 @@ Anyone with write access to a repository can edit comments on issues, pull reque
5050

5151
It's appropriate to edit a comment and remove content that doesn't contribute to the conversation and violates your community's code of conduct{% ifversion fpt or ghec %} or GitHub's [Community Guidelines](/free-pro-team@latest/github/site-policy/github-community-guidelines){% endif %}.
5252

53-
When you edit a comment, note the location that the content was removed from and optionally, the reason for removing it.
53+
Sometimes it may make sense to clearly indicate edits and their justification.
5454

55-
Anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit.
55+
That said, anyone with read access to a repository can view a comment's edit history. The **edited** dropdown at the top of the comment contains a history of edits showing the user and timestamp for each edit.
5656

5757
![Comment with added note that content was redacted](/assets/images/help/repository/content-redacted-comment.png)
5858

59+
## Redacting sensitive information
60+
5961
Comment authors and anyone with write access to a repository can also delete sensitive information from a comment's edit history. For more information, see "[Tracking changes in a comment](/communities/moderating-comments-and-conversations/tracking-changes-in-a-comment)."
6062

6163
1. Navigate to the comment you'd like to edit.
@@ -71,20 +73,22 @@ Comment authors and anyone with write access to a repository can also delete sen
7173

7274
Anyone with write access to a repository can delete comments on issues, pull requests, and commits. Organization owners, team maintainers, and the comment author can also delete a comment on a team page.
7375

76+
If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.
77+
7478
Deleting a comment is your last resort as a moderator. It's appropriate to delete a comment if the entire comment adds no constructive content to a conversation and violates your community's code of conduct{% ifversion fpt or ghec %} or GitHub's [Community Guidelines](/free-pro-team@latest/github/site-policy/github-community-guidelines){% endif %}.
7579

7680
Deleting a comment creates a timeline event that is visible to anyone with read access to the repository. However, the username of the person who deleted the comment is only visible to people with write access to the repository. For anyone without write access, the timeline event is anonymized.
7781

7882
![Anonymized timeline event for a deleted comment](/assets/images/help/issues/anonymized-timeline-entry-for-deleted-comment.png)
7983

80-
If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.
81-
8284
{% note %}
8385

8486
**Note:** The initial comment (or body) of an issue or pull request can't be deleted. Instead, you can edit issue and pull request bodies to remove unwanted content.
8587

8688
{% endnote %}
8789

90+
### Steps to delete a comment
91+
8892
1. Navigate to the comment you'd like to delete.
8993
2. In the upper-right corner of the comment, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Delete**.
9094
![The horizontal kebab icon and comment moderation menu showing the edit, hide, delete, and report options](/assets/images/help/repository/comment-menu.png)

0 commit comments

Comments
 (0)