fixed some typo, added code hints