Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tweaks for managing disruptive comments #17280

Merged
merged 4 commits into from
May 11, 2022
Merged

Tweaks for managing disruptive comments #17280

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4370292
Tweaks for managing disruptive comments
jsoref Apr 21, 2022
ea70084
Merge branch 'main' into disruptive-comment-tweaks
hubwriter May 10, 2022
4d47567
Merge branch 'main' into disruptive-comment-tweaks
ramyaparimi May 10, 2022
9c99d7c
Merge branch 'main' into disruptive-comment-tweaks
hubwriter May 11, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions ...mmunities/moderating-comments-and-conversations/managing-disruptive-comments.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,12 +50,14 @@ Anyone with write access to a repository can edit comments on issues, pull reque

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 %}.

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

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.
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.

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

## Redacting sensitive information

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)."

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

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.

If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.

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 %}.

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.

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

If a comment contains some constructive content that adds to the conversation in the issue or pull request, you can edit the comment instead.

{% note %}

**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.

{% endnote %}

### Steps to delete a comment

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