docs: general messaging scheme