fixing minor typo, updating comments and documentation