minor tweaks to documented sections