[doc] document the messaging interface