documentation fixes and refinements