Timeline for Documentation Update, August 4th [closed]
Current License: CC BY-SA 3.0
75 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Nov 18, 2017 at 17:00 | review | Reopen votes | |||
Nov 18, 2017 at 17:55 | |||||
Nov 18, 2017 at 16:52 | history | closed |
Robert Columbia Stephen RauchMod Glorfindel Veve il_raffa |
Not suitable for this site | |
Nov 18, 2017 at 15:59 | review | Close votes | |||
Nov 18, 2017 at 16:52 | |||||
Aug 1, 2017 at 10:42 | answer | added | Abdulla Nilam | timeline score: 0 | |
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/
|
|
Aug 29, 2016 at 18:09 | history | edited | Kevin Montrose |
edited tags
|
|
Aug 26, 2016 at 1:26 | answer | added | auden | timeline score: 2 | |
Aug 25, 2016 at 0:36 | comment | added | zondo | @rdans: Don't you mean 6 to 8 weeks? | |
Aug 24, 2016 at 8:11 | comment | added | rdans | can you tell us if search is being improved in the next release? | |
Aug 24, 2016 at 8:06 | comment | added | rdans | "regular (roughly weekly) updates" is becoming 4-6 weeks | |
Aug 23, 2016 at 8:49 | comment | added | NoDataDumpNoContribution | Is there some statistics available how contributions and visits to Documentation have developed since the public start? | |
Aug 19, 2016 at 19:46 | comment | added | Pekka |
why would I use it to back me up? Unless it's a super-specific issue that requires totally exact info from a project's maintainers, I could think of a number of reasons to link to a (future, healthy, well-updated) SO docs rather than official docs - an expectation of longevity; of a uniform URL scheme; of a widely recognized layout and format; a standardized, formalized way of fixing problems in the docs, or extending it yourself... on the basis that ten thousand eyeballs can see most errors in it, and get them fixed. (How that would work alongside official docs is a different question.)
|
|
Aug 18, 2016 at 15:31 | comment | added | Mark Schultheiss | Is it just me or should this "documentation" be in documentation? | |
Aug 15, 2016 at 15:48 | comment | added | TylerH | @MarkAmery For the examples | |
Aug 15, 2016 at 15:47 | comment | added | TylerH | @Adam I would hope their threshold for 'high rep' users would be significantly higher than 200 reputation (or 300 with the rep assoc bonus). I'm thinking 5,000 or 10,000. | |
Aug 15, 2016 at 15:46 | comment | added | TylerH | Any news on when the next update will come? Closing in on two weeks now. | |
Aug 10, 2016 at 10:02 | comment | added | Mark Amery | Why would I want to cite Stack Overflow documentation? I cite official documentation because it is an authority - I don't expect readers of my answer to blindly trust me, so I try to evidence all my claims, sometimes by quotes from official documentation or the pronouncements of a language's or library's own developers. Stack Overflow Documentation simply doesn't carry that authority - there's no reason somebody reading my answer would think Documentation is in any way more trustworthy than I am, so why would I use it to back me up? | |
Aug 9, 2016 at 21:23 | comment | added | Daniel Nugent |
Just to note, it seem that the tag alias functionality is not working with an Android silver badge. My change in the android-activity tag went to review....
|
|
Aug 9, 2016 at 18:53 | answer | added | adv12 | timeline score: -1 | |
Aug 9, 2016 at 15:08 | comment | added | Adam | At a minimum it ought to be the 200 rep without site bonus. | |
Aug 9, 2016 at 14:45 | history | edited | TylerH | CC BY-SA 3.0 |
added 1 character in body
|
Aug 9, 2016 at 13:57 | comment | added | TylerH | @DanielM. It's likely not decided yet | |
Aug 8, 2016 at 16:44 | answer | added | user128511 | timeline score: 4 | |
Aug 7, 2016 at 17:35 | answer | added | RubberDuck | timeline score: 6 | |
Aug 7, 2016 at 15:50 | comment | added | NoDataDumpNoContribution | Btw. upcoming Write the Docs conference September 18-20 in Prague. Prague is a beautiful city and with SO now in the Documentation business this might be a good way to get new insights into what Docs may want to be - the topics of the speakers sound quite interesting. | |
Aug 6, 2016 at 20:43 | comment | added | Daniel M. | What counts as a "high rep" editor (for adding >6 examples)? | |
Aug 6, 2016 at 19:40 | history | edited | Peter Mortensen | CC BY-SA 3.0 |
Copy edited (e.g. ref. <http://en.wikipedia.org/wiki/Uniform_resource_locator>).
|
Aug 6, 2016 at 15:11 | answer | added | sambul35 | timeline score: 8 | |
Aug 6, 2016 at 14:46 | answer | added | DavidPostill | timeline score: 24 | |
Aug 6, 2016 at 12:39 | answer | added | Toby | timeline score: 6 | |
Aug 6, 2016 at 12:20 | answer | added | Gabriele Mariotti | timeline score: 3 | |
Aug 6, 2016 at 0:02 | comment | added | mpag | whoever created your mockup (and tag alias examples?) this week must have been staring at the one page I actually edited :P On another note, when you subsumed the tsql tag under sql-server and deleted the tsql entries (as per my request...at least in part), you didn't take away my massive accumulation of 2 rep points. I promise to not abuse my illegitimately gained p0werz resulting from my rep inflated by now-deleted content. | |
Aug 5, 2016 at 22:24 | history | edited | Peter Mortensen | CC BY-SA 3.0 |
added 2 characters in body
|
Aug 5, 2016 at 21:17 | answer | added | Cimbali | timeline score: 0 | |
Aug 5, 2016 at 19:58 | comment | added | Adam Lear StaffMod |
@AlonEitan Whoops, that's my bad. Had a stray ! when writing out the robots meta tag, so it was literally opposite day every time someone would open a topic. Fix pushed, will be live soon.
|
|
Aug 5, 2016 at 18:14 | comment | added | Alex K | @KreepN You have to just to add comment to the row of code in doc's example )). Everyone want to add dot or comma in documentation | |
Aug 5, 2016 at 17:44 | comment | added | Braiam | Is my impression @jtbandes, that Examples.SO is not meant to teach you something... but to get you where the documentation fails. Does the java generics documentation fails to explain what it is? If it doesn't then the documentation shouldn't regurgitate it. | |
Aug 5, 2016 at 14:53 | comment | added | KreepN | @AlexK Seems legit, you know 600 rep for like 3 years then +3500 in like a few months for documentation, ok /S | |
Aug 5, 2016 at 14:43 | answer | added | Braiam | timeline score: 9 | |
Aug 5, 2016 at 14:31 | comment | added | Kurtis Beavers Staff | @AlexK meta.stackoverflow.com/questions/331663/… | |
Aug 5, 2016 at 14:28 | comment | added | Alex K | @KevinMontrose Are you planning to recalculate reputation for users? I have a good sample of growing rep in some popular tags: stackoverflow.com/users/903291/confiqure?tab=reputation. Good tool for cheaters to have +200 per day. Jon Skeet got new competitors ;) | |
Aug 5, 2016 at 13:43 | answer | added | Yakk - Adam Nevraumont | timeline score: 15 | |
Aug 5, 2016 at 13:20 | comment | added | Alon Eitan | @KevinMontrose Why does only the main tag topics pages are crawlable but specific topics are blocked? | |
Aug 5, 2016 at 12:42 | comment | added | Dalija Prasnikar Mod | There are too many examples per topic because there is a need to make things organized. Some additional categorization of topics (maybe via tags) could help to alleviate this problem. For instance Android documentation has 146 topics and it is already unsearchable mess. And some topics have 20 or so examples. Splitting those would make even more mess. Other less popular tags will become just as messy as new content will be added. | |
Aug 5, 2016 at 12:06 | comment | added | NoDataDumpNoContribution | "Too much reputation awarded for contributions to single popular examples" It's easy to say it afterwards, but I really wonder what you were expecting how often popular examples would be voted on. Surely a hundred upvotes for at least 10 distinct editors resulting in thousands of rep was not unreasonable to expect even way before the launch. Well, you see the problem now and will surely find a way to fix it. | |
Aug 5, 2016 at 11:28 | comment | added | Andras Deak -- Слава Україні | @Nicol I've been grumping about SOD since the launch of public beta, so I don't disagree. I just thought I'd play devil's advocate for a change:D | |
Aug 5, 2016 at 9:47 | answer | added | James Donnelly | timeline score: 11 | |
Aug 5, 2016 at 9:31 | answer | added | elegent | timeline score: 81 | |
Aug 5, 2016 at 9:05 | comment | added | Magisch | @KevinMontrose Depending on how you do this, lots of people are going to lose multiple thousand rep a pop, and many of them will lose many privileges they've gained since. I'll expect the storm of whine that follows this to easily dwarf the fallout of the big question rep change recalc. | |
Aug 5, 2016 at 8:41 | comment | added | ken2k | Glad to see you've planned to re-work the reputation stuff from the ground. "Some tweaks" were definitely not enough to fix the currently broken system. | |
Aug 5, 2016 at 8:09 | comment | added | NoDataDumpNoContribution | Sounds all quite good so far. What is missing and hopefully addressed in one of the future updates is "topic organization", "tag discussion" and "edit conflicts". | |
Aug 5, 2016 at 7:38 | comment | added | Ben Aaronson | Focus sections and soft example caps sound good as a way of nudging users into doing things correctly. But what's already there on documentation is going to end up being a massive collection of "broken windows" suggesting alternative behaviour. Dealing with that has to be part of any plan to improve things. | |
Aug 5, 2016 at 4:43 | comment | added | Cody Gray Mod | Well, this is the first "update" to Documentation I've seen that actually looks promising to me. In particular, I'm quite glad to see the "shipped changes" paying attention to established expertise and improving the rejection reasons. Obviously the reputation system still needs some work, as does the horribly confusing UI. It would also be nice if there could be more done to discourage copy-paste from existing, well-done sources of documentation that we seek not to duplicate. Better official guidance on the mission of Docs would go a long way, as would [semi]-automated detection of plagiarism. | |
Aug 5, 2016 at 4:21 | comment | added | jtbandes | Suppose the SO documentation for Java Generics becomes one of the top search engine results for "java generics". Yet, the topic starts with a "focus" of "This topic demonstrates how to use generic types in class and method declarations…" Readers still may not even know what generics are. Should the examples be structured so that "what is this?" is immediately answered by the highest-voted example? Should the section named "focus" actually provide a definition? Or should it link to external documentation? None of these seems to fit the purpose of examples or the "focus" section. | |
Aug 5, 2016 at 2:49 | comment | added | Nicol Bolas | @AndrasDeak: "the hard part is rehashing it in a way that will fix it for good" The problem is not that it's hard. The problem is that they're willing to leave the problem there, letting it fester until they find a way to solve it. Right now, there are quite a few people who have full Q&A edit powers because of Docs.SO. Very soon, there will be at least one person on SO who has close-voting powers solely because of Docs.SO's ridiculous rep gain. This is not a tenable situation, and every day it continues, it becomes worse. "Wait and see" is not something I want to see happen to Q&A. | |
Aug 5, 2016 at 2:07 | answer | added | Nicol Bolas | timeline score: 169 | |
Aug 5, 2016 at 1:10 | comment | added | Kevin Montrose | @knu any changes to the rep system will be accompanied by a rep recalc. We've already done one since launch. | |
Aug 5, 2016 at 0:53 | comment | added | Erwin Brandstetter | @AndrasDeak: I like Jeff's post, which is no surprise after I advocated as much in my answer the day before. And I am not blaming the staff. Typically, it's the management trying to push a new product. The staff has to deal with it. I really don't know who's fault it is. I also don't care much as long as they fix it. | |
Aug 4, 2016 at 23:54 | comment | added | Andras Deak -- Слава Україні | @Erwin, let's give the staff the benefit of the doubt (regardless of our personal beliefs:P). I'm pretty sure they saw that the reputation system is off; the hard part is rehashing it in a way that will fix it for good. Also, having a separate rep system is one among many suggestions that they received. | |
Aug 4, 2016 at 23:11 | comment | added | Erwin Brandstetter | Seriously? It would have taken me 5 minutes on a slow day to figure out that the reputation system for documentation is unbalanced, unfair and incompatible with SO (a.k.a. broken). I am convinced you have smart people working at SO, so I have a hard time believing it took you weeks to start suspecting as much. Looks more like you wanted to create a gold rush to push your new product disregarding collateral damage. It's the oldest dirty trick in the West. It should at least be a separate reputation system so the reputation of innocent bystanders is not devalued. | |
Aug 4, 2016 at 23:09 | comment | added | Andras Deak -- Слава Україні | @Knu there probably will | |
Aug 4, 2016 at 23:06 | comment | added | Knu | Will there be a recalc? | |
Aug 4, 2016 at 21:20 | answer | added | Frank | timeline score: 48 | |
Aug 4, 2016 at 20:47 | comment | added | Rob Grant | @Shog9 oh thank goodness! I was starting to worry that you guys were serious about Docs being for real. World makes sense again :-) | |
Aug 4, 2016 at 20:42 | comment | added | Shog9 | Nice thing about having a beta is we can test out all these crazy ideas that folks have been asking for for years without breaking stuff for thousands of people, @davidism. | |
Aug 4, 2016 at 20:24 | comment | added | Drew | @davidism I couldn't agree more. That said, pleased at least with this as a start | |
Aug 4, 2016 at 20:13 | comment | added | Andras Deak -- Слава Україні | Wonderful, thank you for the intensive background work. One question though: when you say "Documentation" with a capital D, as in "creation of Documentation", as the ultimate purpose: do you mean Examples? I mean that the scope might still have to be specified. | |
Aug 4, 2016 at 20:09 | comment | added | bwoebi | Is example limits something which must be hard-enforced? It definitely should be resolved… but hard-cap? I think it rather should be something like an (un-dissmissable) flag by Community on the topic. That way one can still contribute something, but it gives also a bit time for content to be aggregated first before being split up. Also, soft limit is (I know it can be tweaked, just suggesting) probably too low. PHP Types has one example per type. There are alone like 7 types. Bam, limit immediately reached. That 20 examples are too much, is understandable, 10 examples are not quite too much… | |
Aug 4, 2016 at 19:57 | comment | added | Machavity Mod | I'm happy you can now reject dupes of topics, but what about dupes of other requests? Or at least showing a requester a list of previous requests? | |
Aug 4, 2016 at 19:56 | comment | added | Frank | "This topic covers..." seems too wordy to actually bother reading. I expect to write only sentence fragments, like "Array creation, modification and common operations" | |
Aug 4, 2016 at 19:55 | comment | added | davidism | So when is the "approve and reject edits with gold badge" and "votes count more with more rep" changes going to roll out to Q&A? :-) Seriously, that makes maintaining the docs a lot more convenient for me, thanks. | |
Aug 4, 2016 at 19:46 | comment | added | KreepN | I'm hoping that that the feedback from meta.stackoverflow.com/questions/329528/… is heavily taken into consideration and retroactively applied. With the devaluation of what reputation represents, your "plan" will surely dictate if people contribute to SO going forward. | |
Aug 4, 2016 at 19:32 | comment | added | TylerH | Very glad to hear about the increased bar for getting edits approved. I'd still like to see a higher bar for having the opportunity to review in the first place, though. 100/200 rep is just too low. | |
Aug 4, 2016 at 19:19 | history | asked | Kevin Montrose | CC BY-SA 3.0 |