Skip to main content
21 events
when toggle format what by license comment
Jun 3, 2020 at 15:29 history edited CommunityBot
Commonmark migration
May 23, 2017 at 12:38 history edited CommunityBot
replaced http://stackoverflow.com/ with https://stackoverflow.com/
Mar 20, 2017 at 9:34 history edited CommunityBot
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
Dec 14, 2016 at 20:25 comment added Dalija Prasnikar Mod 100 reputation is way too low for approving. IMO even 1000 rep is too low for approving changes to Documentation. More strictness is required here.
Dec 9, 2016 at 17:47 comment added Braiam "The problem was people were waiting hours (or longer) to see their changes approved." considering the flip side, I prefer this to the alternative.
Dec 9, 2016 at 17:29 comment added Frank "Perhaps more to the point, if you spot a bad edit, you can immediately rollback the change or fix problems with a subsequent edit.[...] if some bad changes do make it through review, tag experts can quickly correct the problem." I don't know about "quickly" since there aren't great tools for spotting bad edits. The actions/activity section of the tag dashboard doesn't have a "watch" option; and some changes are hidden from there, too meta.stackoverflow.com/q/339055
Dec 9, 2016 at 8:04 comment added NoDataDumpNoContribution @PeterCordes "... I don't know if deleting a lot of "examples" and rewriting them from scratch would be a good thing or not." Well, if the existing examples are bad (the judgement on this may be subjective) then why not, why shouldn't it be a good thing? In order to keep changes in Documentation documented I would do it one by one, but if I could and would be interested in doing it and had the time, I would definitely do it. We shouldn't be shy to delete bad examples. What good would they do if they stayed in?
Dec 7, 2016 at 21:51 comment added user3185968 @PeterCordes Many of your answers are what the docs should aspire to be. I gave up on docs as well after seeing the c-tag brutalized for too long.
Dec 7, 2016 at 21:49 comment added Peter Cordes Also, the x86 tag wiki already links to a lot of my answers, because I'm the only one who edits it much, and I wrote the answers to be canonical, and because I knew where to find them more easily than other people's answers. If I started "taking over" x86 docs, I worry that people would think I was doing it for self-promotion. (Which is not the case. I'd be happy to link to other people's answers, I just have a much easier time remembering my own answers and adding them to the tag wiki when they've come up a few times as dup targets.)
Dec 7, 2016 at 21:44 comment added Peter Cordes For me it's definitely an issue of the total scope of what should get written being overwhelming in scope, unlike writing an in-depth answer to a specific question. There's so much to do that one afternoon of work would barely make a dent. Also, I don't know if deleting a lot of "examples" and rewriting them from scratch would be a good thing or not.
Dec 7, 2016 at 21:36 comment added Jon Ericson Staff @PeterCordes: Reading your two comments back-to-back neatly illustrates the problem. People who are best suited to write documentation tend not to have the time (or, dare I say, patience) to do it. There demonstrably were not enough reviewers for most tags (even the popular ones) before we rolled out global reviews. But if you look at the long game (as I do) there's plenty of opportunity to fix subpar content right now. The x86 tag is not so active that an interested party couldn't keep up with it. Your gold badge will help too.
Dec 7, 2016 at 21:36 comment added Peter Cordes The user-empowerment argument is a good one, so probably it's still good to allow doc contributions from users without much score in a tag. But do we need to let such users review, too? I guess maybe the qualified reviewers would get overloaded with work carefully reviewing too many low-quality edits, though, so there's no easy solution if we want to allow users to contribute to docs even for high-traffic tags without having spent some time answering / posting questions first.
Dec 7, 2016 at 21:27 comment added Peter Cordes Requiring qualified reviewers would help put a higher quality bar on docs than on answers. Also good for tag wikis. I just really don't understand the SO system of having people review stuff for tags they might not know anything about, except for cases where there's nobody available for those tags. Score in a tag means a lot more than total rep, especially for reviewing docs where changes to other people's posts are not intended to be limited to "non-intrusive" edits for grammar / formatting / minor corrections.
Dec 7, 2016 at 21:26 comment added Peter Cordes @CodyGray: I basically gave up on docs because people were filling up the x86 docs with close-to-accurate stuff faster than I wanted to keep up with fixing it. A lot of the x86 topics omit important points. Apparently the goal of some contributors was "rough idea for total beginners", but even for that goal there are many things that could have been stated better (to avoid being technically wrong without going into whatever detail).
Dec 7, 2016 at 8:25 comment added Cody Gray Mod "If an edit seems plausible (and this one is to me), I'll assume the editor knows what's what." This seems like the most dangerous assumption that you could possibly make. There is a big difference between assuming "good faith" and assuming competence. I agree with assuming good faith, but I don't agree with assuming absolute accuracy. I'm sure the person who made this edit did so in good faith, as I'm sure that most editors do. The problem is, if we care at all about the usefulness and accuracy of our content (and I think it's a given that we do), we cannot use this simplistic of a metric.
Dec 7, 2016 at 6:34 comment added Jonathan Leffler With that said, empowered users will just have to keep their eyes open. It might be nice if that vigilance was not as necessary.
Dec 7, 2016 at 6:32 comment added Jonathan Leffler Re: your addition. Yes, I'm making an assumption that someone has passing knowledge of C (because that's the language in the question; pick your poison for the general case) if they've earned a net positive ranking in the C tag. That's a very poor surrogate for an answer to "does the reviewer understand C and what was written", but it might be better than what we have now. In this case, the Use of English in the change needed help too. I don't suppose anything much will happen, but I live vaguely in hope. I don't know if other reviews by the reviewers show similar signs of robo-reviewing.
Dec 7, 2016 at 6:27 vote accept Jonathan Leffler
Dec 7, 2016 at 4:52 history edited Jon EricsonStaff CC BY-SA 3.0
Figured I might as well go ahead and answer the question, while I'm at it.
Dec 7, 2016 at 1:15 comment added Jonathan Leffler Thanks for the explanation and auxilliary information. I don't doubt it is a tricky problem; if it weren't, a solution would've been implemented. It's a difficult balancing act. I guess it is incumbent on those with privileges who care about a tag to keep an eye on the changes. Fortunately, the rate of change on the C documentation has decreased to a point where periodic checking (less than daily) can keep up with the changes.
Dec 7, 2016 at 1:06 history answered Jon EricsonStaff CC BY-SA 3.0