various doc cleanup and some code cleanup on the visitors

this happened while preparing to generate a new doc for the website.