Timeline for Documentation should be elitist
Current License: CC BY-SA 3.0
29 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
May 23, 2017 at 12:38 | history | edited | CommunityBot |
replaced http://stackoverflow.com/ with https://stackoverflow.com/
|
|
Jan 21, 2017 at 9:31 | comment | added | NoDataDumpNoContribution | "The point of documentation is that, while anyone can edit it, there is enough incentive / functionality available to improve / correct mistakes." That's the crucial point. Documentation needs to actively encourage contributions from highly qualified users more, for example by a better environment (see all the enhancement requests). | |
Dec 22, 2016 at 7:23 | history | edited | Cerbrus | CC BY-SA 3.0 |
Some formatting
|
Dec 21, 2016 at 7:25 | comment | added | Cerbrus | @MikeM.: Derp, that should've been a "v". | |
Dec 21, 2016 at 3:18 | comment | added | Mike M. | @Cerbrus Did you just verbify "strife"? Certainly seems appropriate for this topic. :-) | |
Dec 20, 2016 at 20:43 | comment | added | Cerbrus | @JeffreyBosboom: I hope we strife for higher quality than Wikipedia... | |
Dec 20, 2016 at 20:20 | comment | added | Jeffrey Bosboom | your username will be drowned out in a massive list of names, removing all incentive to contribute, other than pure altruism -- that's the Wikipedia model, and it seems to mostly work. Why does Docs.SO require extrinsic motivation? What makes Docs.SO different? | |
Dec 20, 2016 at 16:27 | comment | added | Nicol Bolas | @GabeSechan: "I'd say start small and grow-" They tried that in Beta, with a curated list of participants over a small set of tags. It didn't exactly yield great results, so they just put it out there for everyone to use. | |
Dec 20, 2016 at 15:37 | comment | added | TylerH | I think he meant "suggest an edit" at silver badge. | |
Dec 20, 2016 at 15:22 | comment | added | Gabe Sechan | @Cerbrus sounds ok to me. It's not that it would never expand, it's that you don't need our want to include the world before you have a good idea what you're doing. If this is documentation, focused and exhaustive is better than a random sprinkling | |
Dec 20, 2016 at 15:19 | comment | added | Cerbrus | @GabeSechan: "Top X tags" places a limitation on who can contribute, regardless of the quality of the contributor. You'd be excluding a massive portion of SO's userbase, just because they don't happen to be specialized in one of the top X tags. For example, .NET is at position 17. It has 109 gold badge owners, at this moment. | |
Dec 20, 2016 at 15:16 | comment | added | Gabe Sechan | @Cerbrus I'd say start small and grow- I'd be ok to just doing the top 10 tags at most, and then adding tags. Trying to do too much too quickly just waters down efforts. Its easier to increase access later than it is to improve quality. | |
Dec 20, 2016 at 15:13 | comment | added | Cerbrus | @GabeSechan: So at how many gold badge users do you draw the line? You can't expect a single user to maintain a topic. Nor 2. Nor 5. | |
Dec 20, 2016 at 14:58 | comment | added | Gabe Sechan | As for why approve at gold and edit at silver- because a gold user should be more knowledgable. We're accepting that we need experts. Those who have demonstrated more knowledge get more authority, because they're more likely to be right. Just like you have a senior engineer code review a junior. This suggestion changes the end goal from quantity to high quality. | |
Dec 20, 2016 at 14:56 | comment | added | Gabe Sechan | I'm ok with not having any documentation if there aren't (enough) gold badge users. It means that topic isn't that useful to the population at large. It also easier to lower the bar for particular tags or in general at a later date when all the kinks are worked out than it is to raise it and get rid of crap. Start small and grow. | |
Dec 20, 2016 at 14:29 | comment | added | Raphael | @g00glen00b That is certainly true, but moot. We can only use data SE/SO has access to, and that's number of posts and number of up/-downvotes received, basically. You can define other criteria than those implied by "silver badge" (a certain number of answers and score) but they will be just as arbitrary. | |
Dec 20, 2016 at 14:16 | comment | added | Cerbrus | @canon: no such verification exists on SO. | |
Dec 20, 2016 at 14:08 | comment | added | canon | Don't we have verified employees for certain companies, e.g.: Microsoft? Couldn't we do something similar for particular technologies/projects if someone wanted to fast-track into documentation? Of course, I don't know how SE verifies that in the first place... | |
Dec 20, 2016 at 13:57 | comment | added | Dimitri Mestdagh | @Raphael "So there are no users we can assume are qualified to answer.", I disagree. Those low-traffic tags still have people answering questions all the time, with quality. The issue here is that there are less questions and the answers are not viewed as often and generate less upvotes. But relatively spoken I think they can easily have as many high quality answers as gold tag holders in popular tags. | |
Dec 20, 2016 at 13:35 | comment | added | Cerbrus | @CodeCaster: I agree that we need a threshold. I'm just explaining that gold badges aren't a suitable one. | |
Dec 20, 2016 at 13:33 | comment | added | Cerbrus | @Bakuriu: That was meant to illustrate that a gold badge is a poor measure of someone's capability of writing good documentation. | |
Dec 20, 2016 at 13:08 | comment | added | Bakuriu | The argument that "gold badgers can write crap too" is a very weak one. Statistically speaking they are much less likely to do so, and if they do other gold badgers will fix this anyway. The point is not that silver/gold badgers are perfect, but that they have at least shown a minimum use of the tag at hand; it's not a guarantee but it's much better than absolutely nothing. This should also reduce spam on Documentation to practically zero... I doubt spammers want to spent the time and effort to achieve a silver/gold badge in order to post some spam there, that gets remove in seconds. | |
Dec 20, 2016 at 12:37 | comment | added | CodeCaster | I think this answer focuses too much on the tag badges that were suggested as a threshold. We do need some kind of gatekeepers per tag (multiple people), who knows what's already in there (to fight duplication), who collaboratively decide what's on-topic for the tag (to make sure the docs focus on the right thing), who know of best practices in the language or framework (to prevent bad advice), and so on. As of now, anyone who can post something that looks like code and reads like English will get their content approved. | |
Dec 20, 2016 at 12:23 | comment | added | Raphael | "What if someone that works for <tag> registers? He couldn't contribute to the tag's documentation for quite some time." -- We could introduce "professional" badges for tags that correspond exactly to one project or company. That said, this may be a non-issue: SE never cares about actual competence but only about how much rep you've farmed. I'm pretty sure you don't want to open this can of worms here. | |
Dec 20, 2016 at 12:21 | comment | added | Raphael | "Tags that have enough traffic on here to get documented [...] don't necessarily have any silver badge holders." -- So there are no users we can assume are qualified to answer. One could say this is a good reason to not have any documentation on that at all. That ths is okay is the basic assumption of the OP: quality instead of quantity. That means not only less on some topics, but also fewer topics. | |
Dec 20, 2016 at 7:56 | comment | added | Cerbrus | Pessimism aside, I agree there is a lot to be improved about documentation. I just don't think that ((un)intentional) "Elitism" is the answer. | |
Dec 20, 2016 at 7:52 | history | edited | Cerbrus | CC BY-SA 3.0 |
edited body
|
Dec 20, 2016 at 7:47 | history | edited | Cerbrus | CC BY-SA 3.0 |
added 117 characters in body
|
Dec 20, 2016 at 7:42 | history | answered | Cerbrus | CC BY-SA 3.0 |