typo fix + some documentation