Add documentation to socket statuses

I was mislead a little bit into thinking the `isConnected` function would return status of the connection, rather than the socket. I've written some docs to clarify this, and threw in some info for the other socket statuses while I was at it.