Timeline for Documentation should be elitist [closed]
Current License: CC BY-SA 3.0
31 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Jan 26 at 0:07 | comment | added | Peter Mortensen | Documentation was sunsetted in August 2017. | |
Oct 29, 2017 at 6:59 | review | Reopen votes | |||
Oct 29, 2017 at 7:29 | |||||
Oct 29, 2017 at 6:53 | history | closed |
Robert Columbia Stephen RauchMod HaveNoDisplayName Code Lღver S.L. Barth is on codidact.com |
Not suitable for this site | |
Oct 29, 2017 at 4:57 | review | Close votes | |||
Oct 29, 2017 at 6:53 | |||||
Mar 20, 2017 at 9:34 | history | edited | CommunityBot |
replaced http://meta.stackoverflow.com/ with https://meta.stackoverflow.com/
|
|
Dec 22, 2016 at 16:08 | comment | added | evan.oman | @cringe That would be true but people w/ gold or silver badges on SO have demonstrated that they have the time and interest to contribute to the community | |
Dec 21, 2016 at 5:20 | answer | added | Jon EricsonStaffMod | timeline score: 4 | |
Dec 20, 2016 at 18:51 | comment | added | TylerH | @BoltClock True; my suggestion was geared more toward placating the "everyone should be able to edit" crowd by implementing at least a basic quality block. I personally would prefer at least a bronze badge in a tag to be able to suggest edits, a gold badge to make automatic (w/o review) edits, and a silver badge to make/commit to new tag proposals. | |
Dec 20, 2016 at 17:48 | history | edited | Peter Mortensen | CC BY-SA 3.0 |
Copy edited (ref. <https://en.wiktionary.org/wiki/let%27s#Contraction>).
|
Dec 20, 2016 at 17:37 | answer | added | user8397947 | timeline score: -2 | |
Dec 20, 2016 at 17:17 | comment | added | BoltClock Mod | @TylerH: That number would have to scale depending on the tag. Anyone can easily post 5 positively-scored answers in the most popular tags given enough time, and all of a sudden it means they must know what they're talking about. | |
Dec 20, 2016 at 17:06 | comment | added | TylerH | @NicolBolas Haha, no, I mean as a one-time minimum entry, not a new check every time someone wants to contribute. | |
Dec 20, 2016 at 16:32 | comment | added | Nicol Bolas | @TylerH: That's way too ephemeral. of a suggestion. Maybe someone had a busy week at work. Maybe they didn't get to the good questions before they were answered. Maybe they spent their SO time improving Docs rather than answering questions. It seems ridiculous to say that someone had the right to contribute one week but not the next because they didn't put in enough time in Q&A. | |
Dec 20, 2016 at 16:21 | answer | added | Nicol Bolas | timeline score: 25 | |
Dec 20, 2016 at 15:36 | comment | added | TylerH | How about just "you have to have 5 positively-scored answers in this tag that are at least a week old" in order to contribute to Docs for a given tag? | |
Dec 20, 2016 at 15:07 | comment | added | jpaugh | "world-editable, world-moderated content" Wikipedia does get it right, and not just on their protected pages. The biggest problem may be that not enough users are editing documentation in the first place, to find and fix errors promptly. | |
Dec 20, 2016 at 14:55 | comment | added | SGR | Because there are only so many q | |
Dec 20, 2016 at 14:50 | answer | added | Erwin Brandstetter | timeline score: 6 | |
Dec 20, 2016 at 14:31 | answer | added | Zanon | timeline score: 4 | |
Dec 20, 2016 at 12:48 | comment | added | Mark Amery | @CodeCaster I will certainly grant that better answers don't always rise up to the top and have been frustrated several times by my failure to dislodge a bad answer (though I have seen this process succeed, many times - my top 6 answers all outcompeted significantly-upvoted inferior answers on old questions). But at least better answers can be posted (and so can comments point out the bad answers' flaws). That's enough to help a careful and thorough reader. Docs doesn't offer us any real ability to publicly express dissent besides editing and hoping the edit sticks around. | |
Dec 20, 2016 at 12:39 | comment | added | CodeCaster |
@MarkAmery I hate keeping to see that claim. I have yet to see that happen. Good answers do not rise to the top. Answers that provide copy-pasteable code do, whether that code is correct or not. See for example the classical "winforms textbox numerical input" questions, all hundreds of them, where the accepted and highest voted answer claim you should use the KeyPress event for that, which you definitely should not.
|
|
Dec 20, 2016 at 12:35 | comment | added | Mark Amery | "Q&A is mostly ephemeral, with most questions not having long lasting value ... If some question is badly answered it's no big deal; it will be asked again" - :( While this is an accurate description of the current state of Stack Overflow Q&A, it's not how things should be. On the other hand: "eventually a good answer will rise up" - now you've hit the major difference between the two worlds. In Q&A, bad information doesn't matter much because it can be outcompeted by good information. But docs are collaborative, not competitive; the remedy that works well for Q&A is not available. | |
Dec 20, 2016 at 12:33 | comment | added | CodeCaster | See also my question Reviewing changes after the fact, where I suggest that at least a "Subject Matter Expert" (which might be, but doesn't have to be indicated by a badge in the relevant tags) should sign off on every change. | |
Dec 20, 2016 at 12:20 | comment | added | Knu | This only makes sense for the tag that are visible on this page. | |
Dec 20, 2016 at 11:16 | comment | added | user247702 | This looks like a knee-jerk reaction to me. Yes, there are problems as indicated in the "Is Documentation failing" discussion, but I don't believe these suggestions will fix them. | |
Dec 20, 2016 at 7:42 | history | edited | honk | CC BY-SA 3.0 |
fixed name of referenced question and provided a link to it, fixed punctuation and typo, improved markup, fixed capitalization
|
Dec 20, 2016 at 7:42 | answer | added | Cerbrus | timeline score: 89 | |
Dec 20, 2016 at 7:39 | history | edited | honk | CC BY-SA 3.0 |
fixed name of referenced question and provided a link to it, fixed punctuation and typo
|
Dec 20, 2016 at 7:27 | comment | added | cringe | I like the criteria that only silver badges can write docs. But if the bar is set too high, I assume that this will have the same issues than more or less all open source docs are struggling with: the highly skilled and knowledable people are more concerned writing the actual thing than writing the documentation. | |
Dec 20, 2016 at 7:12 | comment | added | Bergi | Maybe let everyone suggest minor edits for typo or grammar fixes | |
Dec 20, 2016 at 5:42 | history | asked | Gabe Sechan | CC BY-SA 3.0 |