Improve documentation for pool and maxSockets options

This has come up several times recently, for example #1150 and #1249.