# Hide and Resolve Comments You can hide Comments that disrupt normal discussions, or Resolve comments that have already been resolved. <img style="display:block;margin:20px auto;padding:1px;border:1px #eee;width:60%;" src="https://hackmd.io/_uploads/HJGKTztvR.png" /> :::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.