doco and small readability tweaks