chg: rework internal doc somewhat