modified message documentation to be more verbose