many documentation fixes