> 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 poss

> 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.)