some doc updates and typo fixes