tweak messaging docs to match implementation