Hacker News new | past | comments | ask | show | jobs | submit login

This. Especially the number of simple examples is lacking. Compare the documentation for node's 'request' with the Python docs for 'requests':

https://github.com/mikeal/request

http://docs.python-requests.org/en/latest/

And 'request' is one of the better documented Node modules! Most authors don't bother with any documentation at all and take an 'if you're too dumb to read the source you shouldn't be using my package' attitude.

Of course there are exceptions, async is pretty nicely documented for example.




The lack of simple examples is far more frustrating than docs personally.


Related question, is there anywhere in the node 'request' docs that describes the structure of the 'response' object?




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: