News for hackers. Stuff that matters.
Re:Stack Overflow Sunsetting Documentation by shubhamjain on Thursday August 03, 2017 @04:42AM (#14917947)
It's possible to overanalyze the outcome but in my opinion, the reason is rather simple: search results. In my programming-related searches, I never saw a result pointing to StackOverflow documentation. Whatever I wanted to know was already answered in a SO question. Take npm documentation for instance, which has covered topics like, "Configuring", "Publishing" npm packages [1].

As much as I loathe the state of documentation of some projects, I'd rarely open a specific website for help - I'll just Google, "publish npm package", "configure npm package", for which, none of the search results point to a StackOverflow documentation page.

[1]: https://stackoverflow.com/documentation/node.js/482/npm#t=20...

Re:Stack Overflow Sunsetting Documentation by pmontra on Thursday August 03, 2017 @05:53AM (#14918236)
Agreed. I didn't even know Documentation existed. I googled for it and eventually picked at random this page about Java lambda expressions [1]. Then I googled for Java lambda and Documentation is not in the first page. To be fair, there are no Stack Overflow results in that page.

However, if I google for a more specific issue such as Java lambda foreach index, guess what's the first link I get? This Stack Overflow page [2] Actually, the first six links are SO pages.

So, it is possible that they busted Documentation because of bad SEO for generic plain vanilla searches.

[1] https://stackoverflow.com/documentation/java/91/lambda-expre...

[2] https://stackoverflow.com/questions/22793006/java-8-foreach-...

Re:Stack Overflow Sunsetting Documentation by touristtam on Thursday August 03, 2017 @04:52AM (#14917987)
I'll one step further: it is the first time I hear about SO's Documentation.
Re:Stack Overflow Sunsetting Documentation by stordoff on Thursday August 03, 2017 @07:31AM (#14918623)
Same here. I've been googling around Django _a lot_ over the last few months (first time using Python for anything web-based, and first time setting up anything more complicated than just nginx/Caddy on the server in a long time, so I had a lot of questions).

I probably ended up on SO hundreds of times in that period, and never once saw Documentation mentioned (I _may_ have technically seen it in the nav bar, but just seeing "Documentation" in that context I'm going to assume it is documentation _for_ SO and just ignore it).

E: Forgot to mention, even reading the title of this post my initial thought was that it was documentation relating to the sunsetting of SO (which sounded crazy).

Re:Stack Overflow Sunsetting Documentation by TuringTest on Thursday August 03, 2017 @08:49AM (#14919054)
> Forgot to mention, even reading the title of this post my initial thought was that it was documentation relating to the sunsetting of SO (which sounded crazy)

And I thought it was Stack Overflow sunsetting the very idea of tech documentation because now everybody just read the SO thread for everything they want to do, which is even craziest.

Re:Stack Overflow Sunsetting Documentation by tedmiston on Thursday August 03, 2017 @10:55AM (#14920093)
Django is a weird case too because the official docs are so good and also offer very good tutorials. And the Two Scoops book is such an invaluable reference too. Reading both would put you in the position where you won't really need SO for Django questions.
Re:Stack Overflow Sunsetting Documentation by stordoff on Thursday August 03, 2017 @02:23PM (#14922248)
Definitely, the official docs are fantastic. A lot of the SO use came from having a solution based on the docs, but wanting to check I wasn't missing a prefered/recommended way to do it, or being fairly sure something would be a Django built-in but not finding it (so SO was a bridge from how I was describing something to where it was in the official docs).
Re:Stack Overflow Sunsetting Documentation by wruza on Thursday August 03, 2017 @05:23AM (#14918118)
Which is strange thing. They always have something [unneeded] in a collapsable block at the top, but I never seen Documentation in there, in SO answers, in google, anywhere.

Few announcements through regular comment notifications would be fine to me even if not interested.

Re:Stack Overflow Sunsetting Documentation by akerro on Thursday August 03, 2017 @05:28AM (#14918132)
>They always have something [unneeded] in a collapsable block at the top

Look again. There is DocumentationBETA in the top bar, it has been there since they started the project.

Re:Stack Overflow Sunsetting Documentation by artofcode on Thursday August 03, 2017 @07:05AM (#14918524)
My first impression when seeing that there is "Why would I look at the documentation for Stackoverflow, I know my way around this website for what I need to do".
Re:Stack Overflow Sunsetting Documentation by pmontra on Thursday August 03, 2017 @08:22AM (#14918886)
Only in the desktop layout, no tablets or phones.

Anyway, who looks at the navbar? People get there by googling a problem they are having now. They're in hurry, no time to look around.

Re:Stack Overflow Sunsetting Documentation by ThisIs_MyName on Thursday August 03, 2017 @07:05AM (#14918521)
I think he's talking about the big unnecessary "Welcome Back!" box that appears randomly.
Re:Stack Overflow Sunsetting Documentation by wruza on Thursday August 03, 2017 @07:37AM (#14918654)
Exactly. Doc-beta link mentioned above is at the area I never focused on. Jobs, >Documentation<, Tags.
Re:Stack Overflow Sunsetting Documentation by chuckdries on Thursday August 03, 2017 @04:54AM (#14917998)
ditto. Now that I know about it, it sounds like a thing I would have liked to use had I known about it.
Re:Stack Overflow Sunsetting Documentation by manigandham on Thursday August 03, 2017 @05:33AM (#14918152)
It's been in the nav bar at the top for a long time - perhaps people just don't look at that anymore.
Re:Stack Overflow Sunsetting Documentation by yjftsjthsd-h on Thursday August 03, 2017 @07:35AM (#14918644)
One datapoint: I completely ignore it, and might even have a ublock rule to throw out what I see as a useless bar.
Re:Stack Overflow Sunsetting Documentation by Doctor_Fegg on Thursday August 03, 2017 @06:58AM (#14918496)
Their root URL is https://stackoverflow.com/documentation

That isn't the top Google result for 'Stack Overflow Documentation'. It's not even on the first page. https://www.google.co.uk/search?q=stack+overflow+documentati...

Re:Stack Overflow Sunsetting Documentation by Sleeep on Thursday August 03, 2017 @07:27AM (#14918604)
There's no such thing as "the top Google result", Google's search algorithms don't serve up the same results for every search for everyone at every time.

My search results were what I'd expect:

http://i.imgur.com/o9gPJ4c.png

Re:Stack Overflow Sunsetting Documentation by Doctor_Fegg on Thursday August 03, 2017 @10:19AM (#14919783)
They still don't include the root. Your results are exactly the same as I get, and resolve to these URLs (in order):

https://stackoverflow.com/tour/documentation

https://stackoverflow.com/documentation/documentation/topics

https://stackoverflow.com/documentation/python/topics

None of these are https://stackoverflow.com/documentation .

Re:Stack Overflow Sunsetting Documentation by laurent123456 on Thursday August 03, 2017 @05:43AM (#14918192)
Yes I'm surprised they don't mention this as a reason for failure because, if it doesn't show up in Google search results, the whole project is doomed regardless of its merits. Nobody is going to go specifically on Documentation, use the custom search, often not find what they are looking for, and then go to Google.
Re:Stack Overflow Sunsetting Documentation by thewhitetulip on Thursday August 03, 2017 @06:27AM (#14918374)
I am sorry, I might be uninformed, may I know the merits of the product? As far as I know it wasn't really helpful. It was like someone built github for writing technical documentation.
Re:Stack Overflow Sunsetting Documentation by laurent123456 on Thursday August 03, 2017 @08:16AM (#14918862)
Some pages are pretty good, and poor quality content gets downvoted and eventually deleted anyway. To take an example if you search for "php mysql" on Google, the top result is a w3school page full of ads with little content.

The Documentation page for this in comparison is helpful and gives a good overview (with more and more detailed topics as you scroll down): https://stackoverflow.com/documentation/php/2784/php-mysqli

But again if it doesn't show up in search results it doesn't matter. That also means there's less of an incentive to improve the content since nobody will read it.

Re:Stack Overflow Sunsetting Documentation by thewhitetulip on Friday August 04, 2017 @01:06AM (#14926450)
Yes, that is the case with everything. I don't know how the ranking of W3 schools is at the top.
Re:Stack Overflow Sunsetting Documentation by mattmanser on Thursday August 03, 2017 @05:03AM (#14918034)
It's possible to do too. Like w3cschools (kerrspit) managed to get to the top with some terrible bootstrap documentation.
Re:Stack Overflow Sunsetting Documentation by DaiPlusPlus on Thursday August 03, 2017 @06:01AM (#14918269)
Now that MDN is an excellent resource, and MS finally made MSDN documentation more search-engine friendly with docs.microsoft.com I'm hoping it will mean W3Schools will be relegated to lower ranked google results.

I don't know how they're able to hold their place still, I really don't.

Re:Stack Overflow Sunsetting Documentation by Drdrdrq on Thursday August 03, 2017 @06:34AM (#14918414)
To be fair, they offered a complete JS reference when none existed (at least that I knew of), in format which was easy to understand. I don't really know where the hate against w3s comes from... I still find them easier to use than MDN for quick lookups.
Re:Stack Overflow Sunsetting Documentation by spondyl on Thursday August 03, 2017 @07:04AM (#14918515)
It's just a real weird site.

It doesn't really teach you anything in depth, opting instead to just spit out a bunch of examples.

As someone who used it initially years back starting out, I would have appreciated if it actually gave me context about how things worked and why rather than just copying and pasting code.

The only real reason it seems to get attention is due to the feedback loop of its ranking. Users see it as a top result and assume it must be some sort of authority on web development.

It has nothing to do with the W3C despite the name. Not to imply that beginners might know about W3C in the first place but still!

I wonder if it's still the same team of 3 developers running the place? Here's a writeup about it http://w3schools.sinsixx.com/about/about_refsnes.asp.htm

Re:Stack Overflow Sunsetting Documentation by shubhamjain on Thursday August 03, 2017 @07:46AM (#14918697)
> It doesn't really teach you anything in depth, opting instead to just spit out a bunch of examples.

You spelt the very reason it is (was?) popular. The documentation/tutorial that gets traffic isn't the one with the most in-depth technical treatment, but, one which gives accessible examples to get started.

Re:Stack Overflow Sunsetting Documentation by yjftsjthsd-h on Thursday August 03, 2017 @07:38AM (#14918658)
Examples are super useful; for the cases I've used w3schools, their example either worked almost directly or at least showed me how to do something quickly. Keep in mind that I'm not a real web dev, so my usecases are trivial stuff.
Re:Stack Overflow Sunsetting Documentation by dmitriid on Thursday August 03, 2017 @09:51AM (#14919538)
Soooo... They were the original StackOverflow ;)
Re:Stack Overflow Sunsetting Documentation by watter on Thursday August 03, 2017 @06:51AM (#14918469)
The hate comes from little inaccuracies that have caused hours of stress and confusion. It is probably not as bad now but I recall getting pretty frustrated after spending hours debugging only to find out the docs were wrong.
Re:Stack Overflow Sunsetting Documentation by Grue3 on Thursday August 03, 2017 @01:12PM (#14921475)
w3schools won because they have absolutely nailed their design. Compare:

https://www.w3schools.com/JSREF/jsref_slice_array.asp

The very first thing is an example. The contrast of the fonts is easy on the eyes. You'll be definitely writing code using this method within minutes.

https://developer.mozilla.org/en/docs/Web/JavaScript/Referen...

The very first thing you see is a huge green box "Why does MDN look different?", which is completely irrelevant to what I'm looking for. Scrolling down reveals thin gray on gray fonts which make the page hard to read. The amount of information is excessive if you're in a hurry.

Re:Stack Overflow Sunsetting Documentation by JimDabell on Saturday August 05, 2017 @08:15AM (#14935359)
Note that it's called W3Schools, not "w3cschools". Lots of people assume they have something to do with the W3C because they named themselves something confusingly similar, but in fact they are not related to the W3C at all.
Re:Stack Overflow Sunsetting Documentation by jwilk on Thursday August 03, 2017 @06:26AM (#14918368)
What's "kerrspit"?
Re:Stack Overflow Sunsetting Documentation by majewsky on Thursday August 03, 2017 @06:31AM (#14918393)
Presumably the noise of spitting in a particularly disgruntled way.
Re:Stack Overflow Sunsetting Documentation by shp0ngle on Thursday August 03, 2017 @07:57AM (#14918753)
This is circular reasoning.

SO Documentation had low Google results because nobody used it, didn't have that many good examples, so people rarely linked it and so it had low pagerank.

Re:Stack Overflow Sunsetting Documentation by BenjiWiebe on Thursday August 03, 2017 @11:03AM (#14920174)
Sounds more like a "vicious circle" than "circular reasoning".