added second batch of documentation fixes