improved docs, fixed typo