News for hackers. Stuff that matters.
Re:Things People Hate about Your Open Source Docs by Apreche on Friday June 21, 2013 @02:36PM (#5920058)
This is 100% true. I am constantly frustrated by incomplete code examples in documentation. The one thing in particular that bothers me the most are when Python snippets don't show the import statements.

do_magic(param, other_param)

Where do I import do_magic from?!?!

Re:Things People Hate about Your Open Source Docs by Cyranix on Friday June 21, 2013 @03:45PM (#5920507)
Same thing in Java -- if there's a class named something commonplace like "Transaction" or "Connection", it's going to be pretty critical to understand whose implementation that refers to.
Re:Things People Hate about Your Open Source Docs by kamjam on Friday June 21, 2013 @04:28PM (#5920786)
Same in .Net, although Resharper (http://www.jetbrains.com/resharper/) has made my life a lot easier by giving me much better import/using suggestions, although not 100% foolproof.