4 ms·
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
by Apreche 13y ago
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?!?!
- Cyranix 13y agoSame 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.
- kamjam 13y agoSame in .Net, although Resharper (http://www.jetbrains.com/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.