4 ms·
> 4. Un-discoverable APIs... One of the main reasons I like python is that it is the most self-documenting language I've come across. Say what you like about s
by foxylad 10y ago
> 4. Un-discoverable APIs...
One of the main reasons I like python is that it is the most self-documenting language I've come across. Say what you like about significant whitespace, but in my last job I used to show salespeople snippets of code and they understood them - with no knowledge of the language.
- icc97 10y agoI agree that the code does document itself well. The biggest problem I have is the docstrings [1] which I find quite weird and find the Javadoc style comments much more readable. [1]: https://www.python.org/dev/peps/pep-0257/