Adding some markdown for explanation of api.