add blog post about new api docs
reorder, remove tldr
language
reorder first paragaph
add User-Agent example
Merge pull request #13 from travis-ci/rkh-api-docs

add blog post about new api docs