minor fixes to docs to address PR feedback