some minor documentation fixes and usability updates