updates docs, fixes typos