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.
Comments
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?