News for hackers. Stuff that matters.
Re:RTFC is the New RTFM by frenchy on Wednesday April 24, 2013 @11:34AM (#5602029)
There is a difference between knowing how to do something and thinking it's a good idea.

Obviously if you need to look at your code for pragmatic purposes, that's fine; but if reading third-party code becomes your modus operandi, you just might be using crappy libraries.

Re:RTFC is the New RTFM by jamieb on Wednesday April 24, 2013 @12:17PM (#5602303)
I'm using Spring 3.1, Jetty, various OWASP, guava. I am in the code of Spring and Jetty on a daily basis, and OWASP when I first used it. I learned guava by writing unit tests to verify my assumptions - assumptions I learned from the documentation - and which turned out to be mostly wrong.

Documentation is ambiguous, and even document which is unambiguous is often wrong.

Re:RTFC is the New RTFM by frenchy on Thursday April 25, 2013 @05:03PM (#5609840)
Writing unit tests is a nice way to work when you're not working in an environment that requires young goat sacrifices or some such thing to perform unit tests. I'd also say that some kinds of unit tests are also a limited form of documentation. They don't tell you why something works the way it does, but they do tell you how it works.
Re:RTFC is the New RTFM by spacemanaki on Wednesday April 24, 2013 @12:44PM (#5602464)
> you just might be using crappy libraries.

Maybe, but sometimes you're stuck with crappy libraries or even crappy frameworks. The last time I had to really dig deep into (ie spend more than 30 mins reading) 3rd party code was when I was trying to figure out if a method in Android's WebView was synchronous or not. [0] Maybe the Android framework, or the WebView specifically is a "crappy library" (the documentation in this case was definitely crappy) but "not using WebView" or "not using Android" wasn't an option.

[0] http://stackoverflow.com/questions/10962150/understanding-an...

Re:RTFC is the New RTFM by frenchy on Thursday April 25, 2013 @04:55PM (#5609805)
Yes, this is certainly a reality for a lot of programmers.
Re:RTFC is the New RTFM by dllthomas on Wednesday April 24, 2013 @11:44AM (#5602104)
> you just might be using crappy libraries

Also, writing crappy code. If you are relying on undocumented behavior, it might well change under you. Looking past the abstraction is sometimes necessary, but it should be the exception.