News for hackers. Stuff that matters.
Re:Has StackOverflow saved billions of dollars in programmer... by taspeotis on Wednesday December 04, 2013 @06:17PM (#6851228)

    The site has enabled software vendors to slack off on their documentation ... I'm thinking of msdn as an example
The number of questions on SO that can be answered by RTFM is quite remarkable. I think that points to a lot of the documentation being just fine. The last bug of my own I spent any significant of time on was answerable by RTFM [1].

There are plenty of PHP+MySQL questions that appear where the OP is clearly learning about PHP+MySQL and the code looks something like...

    $result = mysql_query("select username, password from user where username = " . $username)
...shows that they haven't bothered to RTFM [2].

[1] I had made a new thread and was calling ShellExecute on it. It didn't work on some computers because I hadn't initialised COM (presumably they had some shell extensions installed). See the first sentence of "Remarks" http://msdn.microsoft.com/en-us/library/windows/desktop/bb76...

[2] Big red box: http://www.php.net/mysql_query

Re:Has StackOverflow saved billions of dollars in programmer... by chavesn on Wednesday December 04, 2013 @08:38PM (#6852060)
Why do people assume that RTFM does not have a cost?

In fact, it's probably higher than searching SO through Google. This is why I'm hugely in favor of even basic questions getting answers on SO.

Re:Has StackOverflow saved billions of dollars in programmer... by marvin on Thursday December 05, 2013 @03:57AM (#6853317)
Way higher. Technical documentation is only in rare cases easy to read, whereas SO answers are specifically incentivized to be easily accessible. And any comparison assumes that you can get instantly to the right page of the FM by making a web search, which is far from reality in most cases.
Re:Has StackOverflow saved billions of dollars in programmer... by freehunter on Thursday December 05, 2013 @10:42AM (#6854906)
I've tried out many different programming languages in an effort to be able to "read" any language that comes my way (as a security researcher, I've noticed malware authors tend not to write in enterprise Java). The only language I can think of off the top of my head where the manual is the only thing you really need is Lua. I don't know if it's just because it's so tiny or because it's a well-written manual (or both), but it's lucky that this is the case because finding Lua code examples isn't exactly easy.

Many other languages I've come across have oddities that pretty much require asking someone who already knows the answer.

Re:Has StackOverflow saved billions of dollars in programmer... by mkartic on Thursday December 05, 2013 @02:14AM (#6853083)
very well put. Both obscure and implicit/obvious information can be very hard to find by just reading the manual.

(Aside from above) I love Python. I only know enough to get by though. I have this program that runs for a really long time, storing the results of each iteration in a dict. These results are complex python objects, and are meant to be processed later on.

Naturally, I tried pickling them. As the file grew, Pickle quickly became cumbersome. It was a bad idea to read and write something that big every iteration. I started wondering if there was some way to write pickle objects incrementally. Then googled it, and an answer from SO led me to the 'shelve' module. It does exactly that, pickling objects incrementally. Its part of Python's standard library. But it didn't turn up on the first page of google's results. It is described in the docs as a 'persistent, dictionary-like object'. Well, if not for SO, I would have been stuck with the wrong set of keywords to search with. So, my point is, even if things ARE in the manual, it takes some effort finding it. And SO does an excellent job of leading you on to the right places in the manual/reference rather than just looking down upon you for not grokking the entire manual.

Re:Has StackOverflow saved billions of dollars in programmer... by derleth on Thursday December 05, 2013 @04:57AM (#6853515)
> Well, if not for SO, I would have been stuck with the wrong set of keywords to search with.

This is precisely the sort of bootstrap problem good tutorials are meant to help you avoid. Learning out of a book is not as satisfying as grabbing an interpreter and some example code and just hacking away, but this is precisely a case where the by-the-book method can save you a lot of time and frustration later on.

Another example of a problem tutorials solve is not knowing what 'tasteful' means in a given language. If you don't know what the language culture considers good taste, you'll beat your head against a wall trying to solve problems tasteful developers don't even have, because you're cutting against the grain.

(Yes, yes, a Real Programmer can write FORTRAN-IV in any language.)

Re:Has StackOverflow saved billions of dollars in programmer... by tjbiddle on Wednesday December 04, 2013 @10:10PM (#6852450)
Agreed - Especially when I'm working on some technology where I don't need/want to learn it completely and just can't spare the time, but just need to know a small bit of information to fix some legacy item, or something similar. SO is invaluable there - but I do hate when I'm "that guy".
Re:Has StackOverflow saved billions of dollars in programmer... by dspillett on Thursday December 05, 2013 @06:48AM (#6853919)
RTFM definitely does have a cost, and like you say being able to find the simple questions answered on SO and the rest of the family is very useful to a great many people.

My problem is the duplication of those simple questions: people asking the absolute basics having not bothered to try Google or the site's own search function. They know the right keywords, they've got them in their question, and they'd learn more by looking through the existing answers than by asking a very specific question themselves.

Some people aren't there to learn: they are there to get someone to do their homework/job for them. But many genuinely are and I'd like to help those people where I can, especially those who have obviously given some thought beforehand and articulated their attempt at understanding thus far (it is easier to be helpful in these cases: you often don't have to explain everything in detail you can say "it looks like you've got it almost right, the niggly little thing that you are missing in your understanding is..."). And sometimes even the obvious beginners will actually ask a really interesting question.

From the other side: answers that simple say "Do X" but ofer no further word of explanation are worse than a bad question. A good answer will help the questioner and other passers-by learn from the question+answer, an overly terse answer is just handing the man a fish (and not necessarily the right fish). Luckily there are enough good people contributing on most of the stackexchange sites that the bad answers are outnumbered and the voting system works well enough that the good ones float to the top.

Re:Has StackOverflow saved billions of dollars in programmer... by talkingquickly on Thursday December 05, 2013 @04:14AM (#6853351)
True but I think people often assume, mistakenly, that SO will have a lower cost than RTFM. A great example is Postgres authentication, there are hundreds if not thousands of questions on this topic on SO, almost all of which would be answered by reading the very concise, very accessible section of the Postgres manual.

Not suggesting there's anything wrong with using SO for this but that the cost of reading the manual for these purposes would actually be far lower.

Re:Has StackOverflow saved billions of dollars in programmer... by barrkel on Thursday December 05, 2013 @09:00AM (#6854363)
Your power as a user of software is increased by learning how to read documentation efficiently, however.

It's even further increased by being able to read the source, but that's even more costly.

Re:Has StackOverflow saved billions of dollars in programmer... by rndstr on Thursday December 05, 2013 @07:01PM (#6858315)
I just spent a month getting back into Android development with writing an app. I can't express how many times I knew the answer would be easily findable in the docs but I also knew that by searching on Google it would give me a SO link where it takes about 5-10s to have the answer. While looking it up and reading the SDK documentation would more likely lead to 60-90s with presenting me less information and alternatives.
Re:Has StackOverflow saved billions of dollars in programmer... by ritchiea on Wednesday December 04, 2013 @06:41PM (#6851417)
I want to float a different hypothesis: the perception of programming is so hung up on the idea of individual brilliance that most people, especially beginners, don't even realize how much value there is in reading the manual.

And we as programmers add to the problem. It's not very sexy to say that there is a lot of useful software out there written and documented by smart people and if you read that documentation, and think through a problem with great analytical detail you should be able to find a clear solution.

Re:Has StackOverflow saved billions of dollars in programmer... by ep103 on Wednesday December 04, 2013 @06:53PM (#6851504)
My experience has been that technet's documentation is so unreliable that I've learned to go to SO first.
Re:Has StackOverflow saved billions of dollars in programmer... by doorhammer on Wednesday December 04, 2013 @08:17PM (#6851950)
Yeah, I goto SO (well, SO through google) because with most questions, I get a practical answer to my exact situation in seconds, as well as suggestions as to why or why not different approaches might be warranted. They're not all perfect, but it's usually food for thought.
Re:Has StackOverflow saved billions of dollars in programmer... by RandallBrown on Wednesday December 04, 2013 @09:01PM (#6852166)
StackOverflow is just the manual in an easily searchable form. Lots of times I'm not even sure of what to even look up and that's when I post to StackOverflow. The next time someone else tries to do something similar, Google will have found it in StackOverflow and it will be easily found.
Re:Has StackOverflow saved billions of dollars in programmer... by brc on Wednesday December 04, 2013 @09:31PM (#6852302)
Easily searchable and constantly updated form.

And free of vendor BS, too.

Re:Has StackOverflow saved billions of dollars in programmer... by rbobby on Wednesday December 04, 2013 @11:50PM (#6852766)
Your comment has been closed because it has been deemed to be unsuitable for our question and answer format.

And you're a bad person for asking!

Re:Has StackOverflow saved billions of dollars in programmer... by scotty79 on Wednesday December 04, 2013 @09:57PM (#6852399)
Also has only the information people are actually interested in.
Re:Has StackOverflow saved billions of dollars in programmer... by zxcvvcxz on Wednesday December 04, 2013 @10:14PM (#6852470)
> The number of questions on SO that can be answered by RTFM is quite remarkable. I think that points to a lot of the documentation being just fine.

Actually that must point to the opposite: that manuals are not information resources that are easily consumable, and hence a new service (Stackoverflow and co.) needed to be developed to "disrupt" this.

The more questions the better IMO, it's just more of a wealth of data to search through and serve to people.

I wish there were better ways of asking more general questions that one just has no idea though (e.g. "How can I send SMS messages from a web site?" Random example of which I have no clue). These are more open-ended, but provide a ton of value. At the very least, they make googling for such things that much easier and direct.

Re:Has StackOverflow saved billions of dollars in programmer... by bottled_poe on Wednesday December 04, 2013 @08:35PM (#6852043)
You are quite right. All of the information is in the manual, and if only everyone would spend their time reading the manual there wouldn't be so many questions on SO. However, the volume of information in most manuals is also the problem. If everyone read the whole manual, a lot of time would be collectively wasted because most of the information is not useful or relevant to what each individual developer is trying to do. In my opinion manuals should be written in several tiers of detail. Admittedly, a lot of software developers already publish documentation this way and these basic questions still get submitted to SO.
Re:Has StackOverflow saved billions of dollars in programmer... by nathan_long on Wednesday December 04, 2013 @10:14PM (#6852471)
If you're stringing together a Unix pipe command, TFM might be for, say, awk. Would you rather stop what you're thinking about for 10 minutes and shave that yak, or get a quick answer and move on?
Re:Has StackOverflow saved billions of dollars in programmer... by acdha on Thursday December 05, 2013 @10:20AM (#6854775)
There's another cost to consider: if you do this more than infrequently, learning the tools will save more time than consulting SO repeatedly — particularly if you end up adding and debugging extra steps. Not a big deal for something you're running once but I've seen people running carefully constructed gargantuan shell pipelines multiple times a day because it was "too hard" to learn how to do it all in a single awk / perl step
Re:Has StackOverflow saved billions of dollars in programmer... by nathan_long on Thursday December 05, 2013 @02:04PM (#6856385)
Agreed. But there are yaks you shave but once.
Re:Has StackOverflow saved billions of dollars in programmer... by ako on Thursday December 05, 2013 @12:52AM (#6852908)
The more information is available in the documentation, the more you can benefit from somebody pointing you to the right information for your question. So I think that if software vendors were to document even more, you would need something like stack overflow even more.

And then there's also the problem of cross-technology questions, where you have a question of combining multiple technologies. These kind of questions are usually a bad fit for documentation.

Re:Has StackOverflow saved billions of dollars in programmer... by sebkomianos on Wednesday December 04, 2013 @10:07PM (#6852436)
Not everyone learns from manuals though.
Re:Has StackOverflow saved billions of dollars in programmer... by derleth on Thursday December 05, 2013 @05:02AM (#6853540)
> The number of questions on SO that can be answered by RTFM is quite remarkable.

Every language needs two manuals: A reference text, to teach you what is possible, and a tutorial, to teach you what is tasteful. You should expect people to read the tutorial, but expecting everyone to inhale reference material is a bit much.

(Later, there should be a third book: An anti-tutorial, laying out anti-patterns, or things you shouldn't be doing but that people tend to do anyway, and how to solve the problem the right way, with pointers to other tools if necessary.)