Updating the README for clarity and with links to API docs