rework docs to reduce redundancy