Add more extensive documentation about ws_connbuf

This PR adds more extensive documentation for the connection interface.
wishes?