Skip to main content

Timeline for Sunsetting Documentation

Current License: CC BY-SA 3.0

35 events
when toggle format what by license comment
Aug 7, 2017 at 23:17 comment added HostileFork says dont trust SE "I told you. What did I tell you? Didn't I tell you? 'cuz I told you! Mmm-hmmm. And when did I tell you? A long time ago. And what did I say would happen when I told you? Exactly what just happened!" youtube.com/watch?v=JrGYLNHfUwE :-P
Aug 7, 2017 at 16:13 comment added Tot Zam @Trilarion As I stated in my answer, my intention was to move examples that I created or was the main contributor to. I don't think everyone should just start moving over documentation. One of the biggest problems with documentation is that amount of plagiarisms, so you can't just copy examples that you don't know the source of. Also, majority of documentation already exists on QA, so that information for sure should not be moved over. If you personally feel that a few specific examples are missing from QA, then move those, but this shouldn't be a community migration project.
Aug 7, 2017 at 15:52 comment added NoDataDumpNoContribution @TylerH Okay, then maybe a more flexible approach where everyone decides for himself what a gem is and what not but notifies others one he has converted them to self answered Q&A, so we avoid duplicates. A simple meta Q&A should be okay. If I have time I will open one.
Aug 7, 2017 at 15:08 comment added TylerH @Trilarion Almost certainly not, for several reasons. Not least of which is which topics and examples would be worthy of 'gem' consideration.
Aug 6, 2017 at 20:31 comment added NoDataDumpNoContribution Wonderful idea. Is there a list of the gems of Documentation that aren't yet converted to self answered Q&A available?
Aug 4, 2017 at 18:02 comment added Servy @zaph The morale of the story of course being that if you're going to post a new question on SO you need to ensure that your question is a quality question, that meets all of SO's standards for a good question, and that the answers also need to be good answers, per SO's standards for an answer. Just copy-pasting over something from Documentation that wasn't written to be a good SO question or a good SO answer isn't going to go over well.
Aug 4, 2017 at 12:25 comment added zaph @Jon Ericson I added a self answered question on SO with the contents of documentation I had created and requested feedback. Within minutes it was down-voted, received several more down votes and close votes. Then it was moved to Meta, received morre downvotes on both the question and answers and eventually closed and locked by Cody Gray♦. See the question here.
Aug 3, 2017 at 14:59 comment added Servy The few pieces of good original content can also be moved elsewhere, and that's very likely to happen, so no, you're not losing a ferrari and getting a donkey, you're losing a donkey even though you've owned a ferrari this whole time, and you're complaining about only having a ferrari, instead of your donkey.
Aug 3, 2017 at 14:59 comment added Servy @WillNess Docs is flooded with plagiarized content, duplicated content, incorrect content, poorly written content, etc. Most of what's there isn't even original content to begin with, and is already accessible elsewhere. Of what's left, most is just worse versions of content already accessible elsewhere. Again, this is why it's being removed in the first place, it's full of bad and duplicate content, not original quality content. If you're actually using it (for some unknown reason) then you can just do a search and find the same content somewhere else.
Aug 3, 2017 at 14:53 comment added Will Ness @Servy no, what I have right now, is of great value to me. Next, if accessing something right now costs me 0 effort, and will cost 100,000 on my relative scale of cost of effort, why do you think you have any right to tell me this or that. You don't know my relative effort scale. What's easy enough for you, might be very hard for me. But as I said, you don't want to hear me, and it's fine. just stop telling me I'm an idiot. it's like I have a ferrari, you take it away, give me a donkey instead, and laugh at me complaining, because you're a master donkey-rider. I'm not.
Aug 3, 2017 at 14:43 comment added Servy @WillNess Something that you have right now that's not actually of value, is going to be made less accessible, but is still accessible to you, and because of your unwillingness to access it, it's putting you at the mercy of someone choosing to determine that it's worthwhile enough to host in a way that you're willing to access (which is highly probable). So yes, I call that proving you false. If you don't want to be at the mercy of others, then you don't have to be, but even if you choose to be at the mercy of others, it's still helpful to you.
Aug 3, 2017 at 14:40 comment added Will Ness @Servy something that I have right now, will be taken from me, made inaccessible to me, I will be put at the mercy of someone who might host it if they so choose, and you call it "proving me false". ridiculous, is what it is.
Aug 3, 2017 at 14:38 comment added Servy @WillNess And I explained to you why that's wrong, and how it is useful to you specifically. Repeating something that I've already demonstrated is false, without adding anything new is just wasting everyone's time.
Aug 3, 2017 at 14:35 comment added Will Ness @Servy and I already told you that it is not useful to me, and not having an HTML accessible means heaving a content completely removed - for me. this is what I am telling to you.
Aug 3, 2017 at 14:31 comment added Servy @WillNess Yes, I'm aware of the answer, and as I said, it's correctly downvoted, because it's not a good idea. As I've already told you, it's useful to you because if someone realizes there was some useful content in Docs that didn't get re-hosted, the archive is there for them to re-host it. Your statement that the content is being permanently deleted is false. Even if you don't end up finding one of the rare artifacts that's useful, others will, and will re-host them, helping you. But creating thousands of bad questions, as you're proposing, would be very harmful to the site.
Aug 3, 2017 at 14:29 comment added Will Ness here it is. yes, it has even more downvotes right now. -- no, it isn't useful to me. the only thing useful to me is what I can open in my browser right away, not a zillion zipped XML files. that is not helpful to me, at all. @Servy
Aug 3, 2017 at 14:26 comment added Servy @WillNess Yes, and if you end up missing some content from docs you can pull it out of the data dump and re-host it (in a Q/A, or elsewhere) to ensure it's not lost, so it's highly useful to you if you're trying to find one of the rare pages that actually had some useful information to re-host. The answer asking for a frozen docs is highly downvoted because it wouldn't be useful because there's so much bad content there, and that's the same reason we wouldn't want to just copy all of the pages into QAs.
Aug 3, 2017 at 14:24 comment added Will Ness @Servy it will be available as a JSON/XML/whatevs data dump. Not really that useful to me - and that's a colossal understatement. An answer here asking for a frozen Docs site is heavily downvoted right now. (? or was, when I last read it few minutes ago...)
Aug 3, 2017 at 14:22 comment added Servy @WillNess Where did I say that people should be prohibited from asking questions using the content from Documentation (in the rare cases where they'd actually result in a good question)?
Aug 3, 2017 at 14:21 comment added Will Ness @Servy I've just re-read your comment, and yes, you kinda did.
Aug 3, 2017 at 14:19 comment added Servy @WillNess I didn't say that at all. I said we shouldn't copy over all of it, because the vast majority of it is bad. Feel free to copy over the few bits that are actually useful. And of course it's never going away. The archive will always be available, if you later find out that there was something useful there that you want to re-host elsewhere.
Aug 3, 2017 at 14:17 comment added Will Ness @Servy what you're saying is, lot of it isn't that good, some is very good, and we will through away the good with the bad! and I'm saying, I don't think that's OK.
Aug 3, 2017 at 14:14 comment added Servy @WillNess The whole reason documentation is going away is because it's largely not full of useful information. If most of what's there was actually good content, it wouldn't be being sunset right now in the first place.
Aug 3, 2017 at 13:42 comment added Tot Zam @WillNess A lot (if not majority) of the current documentation already exists in QA. Just moving everything over will create many duplicate posts. I think the only way to do this is by users manually moving over the few item they feel don't yet exist. And this would be only after they do a thorough search to make sure the question really doesn't exist yet.
Aug 3, 2017 at 12:48 comment added Will Ness (continuing) good entries will with time get up-voted more, bad ones will get downvoted, flagged into low-quality queue and deleted, with time. valuable content will be preserved, bad one deleted. a win-win.
Aug 3, 2017 at 12:22 comment added Will Ness @JonEricson so even better, why not convert all of documentation into community-wiki self-answered questions by Community? each example and remarks sections for teach topic automatically converted into their own Q&A entry with some auto-generated title. this will preserve the content a.o.t. destroying it (and letting users on data-dump content chase is just the same as destroying it).
Aug 2, 2017 at 23:49 comment added jscs Also What subjects would be good for a self answered question?
Aug 2, 2017 at 16:13 comment added Jon Ericson Staff @TotZam: I'm going to be talking with the team later today and the link situation is almost certainly going to be our main topic. We got a lot of useful feedback here that might change our plans. Keeping the link will be useful information no matter what happens.
Aug 2, 2017 at 15:53 comment added gnat you might find this guidance useful: How to ask and self-answer a correct, high quality Q&A pair without attracting downvotes?
Aug 2, 2017 at 15:15 comment added Tot Zam @JonEricson It seems silly, though, to include a link that very soon will not work.
Aug 2, 2017 at 15:04 comment added Jon Ericson Staff The only real problem is with attribution. This is also a flaw with editing examples into posts. For the moment, go ahead and link back to the Example as it currently exists on Docs.
Aug 2, 2017 at 14:44 comment added Tot Zam @JonEricson Would it be correct to also include edits that others made to the examples?
Aug 2, 2017 at 14:33 history edited Tot Zam CC BY-SA 3.0
added 24 characters in body
Aug 2, 2017 at 14:32 comment added Jon Ericson Staff That sounds like a great idea! Having written my share of self-answered questions, my advice is to focus on the question and be sure there can be alternate answers.
Aug 2, 2017 at 14:22 history answered Tot Zam CC BY-SA 3.0