add some documentation to the send() view of messages