On thing that have always confused me with Discourse is the review queue: when I look at a post (like the one below) there are two buttons: Approve and Reject. However I never know what I’m approving or rejecting: is it the post, or is it the flag? If I reject the post, it’s going to be blocked I guess, but if I reject the flag, the post is going to be published.
It’s basically two opposite behaviours and I really have now idea what’s going to happen when I click the buttons. Also there’s no experimenting here because once I’ve clicked on one of the button, the post is removed from this screen. But maybe I’d like to check the user, maybe block them, etc. I might also want to verify if the post is gone or not, etc. (because I have no idea what these buttons do, I often mis-click and find that spam posts are still there so I need to go find them and delete them).
So I think it should be made clearer what’s going to happen. Maybe the buttons could be labelled like this:
Approve flag and delete post
Approve flag and mark post as spam
Reject flag and keep post
Approve post and publish it
Reject post and mark it as spam
And provide a link to the post that’s been processed, to allow us to check it.
Anyway, I think it’s one area where there’s no need to go KISS, and instead keep the actions as clear and detailed as possible.
There are a few different things that will appear in the “Needs Review” page.
The example in your screenshot is a post that needs approval. You can see the nature of the review record in the upper left (“Queued Post” in this case) The reason the post requires approval is displayed at the bottom of the record. In this case it was “The poster typed in their post suspiciously fast.” There is also a link pointing to the setting in your admin panel that would allow you to adjust the rules that determine which posts will require approval. Clicking the “Approve” button will allow the post to go through, whereas clicking the “Reject” button will delete the post. The other two buttons should be fairly self-explanatory.
If you go to ryanalex’s profile, there’s a button labeled “Admin” This will take you to the user admin page where you can delete the user. When deleting a user from the review queue, you will delete all of their posts, including the one that’s shown in the queue.
If there’s anything that’s still unclear, let us know and we’ll try to improve our documentation.
I can see how this is confusing. Normally, with a flag you Agree or Disagree. In that case you’re agreeing or disagreeing with the flag. Here we have a queued post. Approve and reject refers to the post, not the “flag”. This is extra confusing because we’re using the flag icon next to the words “Needs Approval”. With the recent change in Confused by "Approve" and "Reject" in the review queue, perhaps we can add the word “post” to the approve and reject buttons?