Managing disruptive comments

Hiding a comment

Anyone with write access to a repository, can hide comments on issues, pull requests, and commits.

If a comment is off-topic, outdated, or resolved, you may want to hide a comment to keep a discussion focused or make a pull request easier to navigate and review. Hidden comments are minimized but people with read access to the repository can expand them.

1. Navigate to the comment you'd like to hide.

2. In the upper-right corner of the comment, click , then click Hide.

3. Using the "Choose a reason" drop-down menu, click a reason to hide the comment. Then click, Hide comment.

   

Unhiding a comment

Anyone with write access to a repository, can unhide comments on issues, pull requests, and commits.

1. Navigate to the comment you'd like to unhide.
2. In the upper-right corner of the comment, click Show comment.
3. On the right side of the expanded comment, click , then Unhide.

Editing a comment

Anyone with write access to a repository can edit comments on issues, pull requests, and commits.

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.

Sometimes it may make sense to clearly indicate edits and their justification.

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.

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

1. Navigate to the comment you'd like to edit.
2. In the upper-right corner of the comment, click , then click Edit.
3. In the comment window, delete the content you'd like to remove, then type [REDACTED] to replace it.
4. At the bottom of the comment, type a note indicating that you have edited the comment, and optionally, why you edited the comment.
5. Click Update comment.

Deleting a comment

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.

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.

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 , then click Delete.
3. Optionally, write a comment noting that you deleted a comment and why.