get rid of some duplication in README
add markdown file for api