diff --git a/docs/_docs/03-03-product-guide-moderator-features.md b/docs/_docs/03-03-product-guide-moderator-features.md index 355c40a1c..142fb8652 100644 --- a/docs/_docs/03-03-product-guide-moderator-features.md +++ b/docs/_docs/03-03-product-guide-moderator-features.md @@ -2,3 +2,128 @@ title: Moderator Features permalink: /moderator-features/ --- + +## The Talk Admin + +The Admin is your moderators will moderate your comments, and your Admins will configure and manage the different parts of Talk. + +### Dashboard + +The Dashboard provides real-time information to moderators so they know at a glance where they should direct their attention. It shows what articles are receiving the most reports and where the most active conversations are happening. + +### Moderate + +This is the tab where Moderators will spend the majority of their time. They can choose (via the dropdown) which story they would like to moderate, or moderate site-wide. + +#### Default Mod Queues + +**New** + +The New queue contains all comments that have not been moderated yet. + +**Reported** + +The Reported queue contains all comments that need moderator attention. + +**Approved** + +The Approved queue contains all approved comments. + +**Rejected** + +The Rejected queue contains all comments that have been rejected, either manually by moderators or automatically, e.g. they have used a banned word. + +**All** + +The All queue contains all comments that have been submitted either article or site-wide. + +#### Moderation Badges + +**Pre-mod** + +The Pre-mod badge signifies comments that are being pre-modded. + +**User** + +The User badge signifies comments that have been reported by another user. + +**History** + +The History badge signifies comments that have been flagged because of a user’s history. + +**Toxic** + +The Toxic badge signifies comments that are above the set Toxicity Probability Threshold. Note you must have `talk-plugin-toxic-comments` enabled. [Read more about Toxic Comments here](LINK). + +**Suspect** + +The Suspect badge signifies comments that contain a Suspect Word. [Read more about Suspect Words here](LINK). + +**Contains Link** + +The Contains Link badge signifies a comment that contains a link, which can sometimes mean it is a spam or ad comment. + +**Flag Details View** + +At the bottom of each comment in the moderation queues, you can see more information about a comment’s flags by clicking on More Detail. + +#### Moderator Actions + +**Accept** + +Accepting a comment ensures that the comment is displayed on the stream. + +**Reject** + +Rejecting a comment removes the comment from the stream. + +**Feature** + +Featuring a comment adds that comment to the Featured Comments tab on the stream. + +**Suspend User** + +Suspending a user allows a moderator to give a commenter a “time-out”; during that time they won’t be allowed to post comments or react to comments. + +**Ban User** + +Banning a user allows a moderator to permanently disallow a commenter to interact with their community. The commenter’s previous comments will remain on the site. This action can only be un-done manually by a moderator. + +#### Viewing a User’s Comment History + +In order to get an idea of what sort of a commenter someone is, moderators can click on the commenter’s username in any moderation queue and see details about their history. + +**Username, Email and Member Since Date** + +This shows the basic details about a commenter. + +**Total Comments** + +This shows the number of comments that a commenter has made that currently display on the site. + +**Reject Rate** + +This shows the % of comments a commenter has had rejected by moderators, or automatically. + +**Reports** + +This shows if a commenter is a reliable flagger, an unreliable flagger, or a neutral flagger. [Read more about reliable and unreliable flaggers here](LINK). + +**Moderating from this View** + +Talk also allows you to moderate a commenter’s recent comments from this view. + +#### Keyboard Shortcuts + +Talk also supports a number of keyboard shortcuts that moderators can leverage to moderate quickly: + +| Shortcut | Action | +| -------- | ------------------------------- | +| `j` | Go to the next comment | +| `k` | Go to the previous comment | +| `ctrl+f` | Open search | +| `t` | Switch queues | +| `s` | Toggle single comment edit view | +| `?` | Open this menu | +| `d` | Approve | +| `f` | Reject |