50

Now that the masses are allowed to make documentation changes, reviewing their pending requests is more important than ever. The number of edits jumped by several orders of magnitude across the board, and we're getting lots of crap edits that need to be declined or significantly improved.

However, if you look at the pending edits list for a tag, you can't tell which ones you've reviewed and which ones you haven't.

We either need the ability to cull those you've already reviewed, or we need a real review queue per-tag that works like the Stack Exchange review queue.

Also, I just found out that there's a limit to how much you can review in a day. That's... a very bad thing, especially given the massive degrading of edit quality coupled with the massive increase in the number of edits.

10
  • Oh, how much is the limit then? I didn't hit that one yet ...
    – rene
    Commented Jul 21, 2016 at 17:25
  • It's reasonably high, @rene. Just an insane number of people submitting edits right now, and throttling is pretty generous.
    – Shog9
    Commented Jul 21, 2016 at 17:54
  • 8
    @Shog9: I don't believe that 30 is "reasonably high" for what Docs.SO is doing. On SO, if you have enough reputation, your edits don't need to be reviewed. On Docs.SO, they always need review. So you have to "waste" reviews on people who actually know what they're talking about. Commented Jul 21, 2016 at 18:43
  • It can be changed if necessary; that said, only 14 people - about 1% of reviewers - have hit that cap so far today; it'll take a few days to get a feel for where this should be, how many reviews are necessary, etc. We have some idea of where this should fall based on suggested edits, but as you note they're not quite the same thing.
    – Shog9
    Commented Jul 21, 2016 at 18:53
  • 7
    Never mind the needs of the "average" reviewer, why is there a review cap at all? It already doesn't make sense for edit suggestions on Q&A, it makes less than no sense when literally nothing can be done without review. That's fully half of the contribution you make to working on Docs.
    – jscs
    Commented Jul 21, 2016 at 19:13
  • 3
    I'm in the 1% now of users that hit the cap, needed two more...
    – rene
    Commented Jul 21, 2016 at 19:17
  • 3
    @Shog9: It should be noted that people are hitting the review cap even though 1) Docs.SO hasn't been online for 24 hours, and 2) we still have ~5 hours before the cap gets reset. So I'd say that's a strong indicator that the cap needs to be expanded, if not removed entirely. I agree with Josh; it's not clear what kind of behavior we are attempting to stop by capping reviews. Commented Jul 21, 2016 at 19:20
  • I expect reviewers fatigue to be the reason ...
    – rene
    Commented Jul 21, 2016 at 19:22
  • 4
    Plenty of people hit the normal review caps every day, @Nicol. That's very much intended - you don't necessarily want the same people reviewing everything, especially when there's a very large amount of everything. Quite honestly, 30/day is pretty high for anything beyond trivial changes - I don't expect most folks to sustain that. Eventually, we're gonna need something akin to privileged edits.
    – Shog9
    Commented Jul 21, 2016 at 20:11
  • 2
    I am also waiting days for reviews. Now I have 10 pending and can't add any more documentation!
    – Will
    Commented Jul 24, 2016 at 5:53

1 Answer 1

9

We're working on a review queue that functions very similar to the Suggested Edits queue in Q&A.

A rough mockup is mentioned in this post. More to come soon.

2
  • do you plan to have review-audits in this queue?
    – gnat
    Commented Jul 27, 2016 at 17:55
  • 1
    @gnat short answer — probably but not necessarily in the first release. I agree that's an important feature, but it will be much quicker in the short-term to release a review queue without it then progressively improve with audits after we get the MVP out. Commented Jul 27, 2016 at 18:00

Not the answer you're looking for? Browse other questions tagged .
https://meta.stackoverflow.com/questions/328645/docs-so-needs-a-review-queue?noredirect=1
meta.stackoverflow.com
CC-MAIN-2024-38
126384
application/http; msgtype=response
sha1:GTR33ZG6TWPBCTW72UNQAIC5TUHV7YOV
<urn:uuid:7783b3cd-33d7-4972-b927-67933d01e839>
2024-09-08T07:02:34Z
104.18.32.7
text/html
sha1:U7B4NHWM7FRRU2W64RY7FC272WJZQYGY
<urn:uuid:f735d187-c950-4616-8275-c5899906e925>
https://meta.stackoverflow.com/questions/328645/docs-so-needs-a-review-queue?noredirect=1
response
<urn:uuid:0ec323a8-01f8-43b3-9439-98d562f73217>
isPartOf: CC-MAIN-2024-38
publisher: Common Crawl
description: Wide crawl of the web for September 2024
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-228
software: Apache Nutch 1.20 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.5-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/