Hacker News Reader

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?!?!

View on HN

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.

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.

Reply on news.ycombinator.com