fixing some typo and adding link to the api doc