Add more extensive documentation about ws_connbuf

This PR adds more extensive documentation for the connection interface.
ease --> facilitate