added additional documentation and fixed minor typo