consistently return URLS for resources
first docs for the API
add link for API docs
single -> double quotes
smaller headings
consistent punctuation
escape < and > characters
Merge pull request #9 from waltaskew/feature/api-docs

In which we add much-deserved API documentation