# Hide and Resolve Comments

You can hide Comments that disrupt normal discussions, or Resolve comments that have already been resolved.

:::info
### 💡 Try suggest edit

Sometimes we leave comments to point out a typo, suggest a better phrase, or add a new perspective to the text. These comments are like scaffolding on a text that is expected to be removed once the text leaves the draft stage and faces a wider readership.

For these scaffolding edits, suggesting edits is a better choice than comments.

[Learn more on suggest edits →](https://hackmd.io/@docs/suggest-edit-en)

:::

|Feature|Allowed roles|
|-|-|
Hide|Writer and above
Unhide|Writer and above
Resolve|Writer and above
Revert|Writer and above

## Hide comments

Hiding comments allows users to minimize comments that are not relevant or have been resolved.

Hiding a comment does not completely remove it from the comment panel to maintain transparency and accountability in the editing and discussion process.

Keyboard shortcut: <kbd>h</kbd>

1. Select the comment you wish to hide.
2. Choose the 'Hide' option from the comment menu.
3. Select a reason for hiding the comment or leave it blank.
4. The comment will be hidden and marked with the chosen reason.

## Unhide a comment

Allows users to unhide previously hidden comments.

1. Select the hidden comment you wish to unhide.
2. Choose the 'Unhide' option from the comment menu.
3. The comment will be restored to its normal state.

## Resolve a comment

Mark a comment as resolved, which is essentially a shortcut for hiding a comment with the reason "Resolved".

Keyboard shortcut: <kbd>R</kbd> (Capital `R`, press <kbd>Shift</kbd> + <kbd>r</kbd> when Caps Lock is off)

:::info
### 💡 Pining comments as a to-do list
Use in conjunction with pinning comments that need attention. Delegate or get back to the "to-do comments" later. Once resolved, mark the comment as such.

Keyboard shortcut for pinning comments: <kbd>p</kbd>
:::

1. Select the comment you wish to resolve.
2. Choose the 'Resolve' option from the comment menu.
3. The comment will be hidden and marked as 'Resolved'.

## Revert Resolved

Reverts a resolved comment back to its original state.

1. Select the resolved comment you wish to revert.
2. Choose the 'Revert Resolved' option from the comment menu.
3. The comment will be restored to its original state.