further tweaks to doc