begin to flesh out documentation for message passing primitives