more doc tweaks, and a visual aid