docs for sockets module and more tests passing
more docs and tests fixes