clarified docs, fixed typos