a ton of fixes to docs