a couple of tweaks to the  docs