small documentation fixes and improvements