describe & generate API docs from markdown
Add POST (shorten) to api docs
minor copy change
add notes to readme about API docs