Add more extensive documentation about ws_connbuf

This PR adds more extensive documentation for the connection interface.
it seems like a noun is missing after "serialized"