Timeline for How to handle questions that have answers in the language's documentation?
Current License: CC BY-SA 3.0
12 events
when toggle format | what | by | license | comment | |
---|---|---|---|---|---|
Jun 22, 2015 at 20:11 | comment | added | Yakk - Adam Nevraumont | C++ language-lawyer is about 50% hit and miss with the standard itself. The other half are "congratulations, you found a defect that someone else already found. The committee is considering how to reword that bit." ;) | |
Jun 19, 2014 at 6:15 | comment | added | BoltClock Mod | Even TV Tropes has this well-covered (albeit for video games mostly): tvtropes.org/pmwiki/pmwiki.php/Main/GuideDangIt tvtropes.org/pmwiki/pmwiki.php/Main/ManualMisprint tvtropes.org/pmwiki/pmwiki.php/Main/TutorialFailure | |
Jun 18, 2014 at 23:22 | comment | added | jpmc26 | "There is a lot of bad, confusing, and misleading documentation out there. There is plenty more that requires a sufficiently in-depth understanding of the library before one can make heads or tails out of what it is trying to say." Thank you. Just, thank you. Dealing with this right now. This cannot be emphasized enough. Even xkcd acknowledges it: xkcd.com/1343. Needs an extra data point, though: tools with a manual you can't read. | |
Jun 17, 2014 at 23:35 | comment | added | Radiodef | I would change #2 to 'paraphrase the docs' in most circumstances because some documentation has legal guidelines that forbid copying it. For example the Java tutorials. | |
Jun 17, 2014 at 15:06 | comment | added | Alex KeySmith | It's also good to note, that unless you know where to find it or the exact search phrase it can be difficult to dig into official documentation. StackOverflow often acts as a good resource to unearth gems hidden in documentation libraries. | |
Jun 17, 2014 at 14:38 | comment | added | Andy | I would also add that some more obscure libraries having documentation with answers may be unreachable by the asker due to corporate firewalls and the like. It's always best to provide an answer and not just a link. | |
Jun 17, 2014 at 14:35 | comment | added | leonbloy | Among my 818 answers in SO, this is the most upvoted one. Rather depressing, in some respect, but anyway, I guess the upvotes are from people who have found that useful. | |
Jun 17, 2014 at 8:53 | comment | added | Cody Gray Mod | I'm saying that all or nearly all of them can be answered by looking in the docs. It doesn't make them worthy of a downvote. @cup | |
Jun 17, 2014 at 8:19 | comment | added | Cody Gray Mod | @Cup You can downvote for whatever reason you want, I don't personally agree with that outlook. How many questions can you find in the git tag that cannot be answered either by looking in the official documentation or one or more books about Git? One of our friendly moderators just posted this self-answered question. I haven't checked, but I'll bet that information is documented somewhere. Of course, now it's documented on Stack Overflow, which is what we're interested in. | |
Jun 17, 2014 at 8:10 | vote | accept | Cerbrus | ||
Jun 17, 2014 at 7:59 | comment | added | Cerbrus | This actually makes a lot of sense. Users posting questions that can be answered from the docs may not have sufficient understanding to search for the answer in those docs, didn't think of that. | |
Jun 17, 2014 at 7:55 | history | answered | Cody GrayMod | CC BY-SA 3.0 |