Update API docs, move back to README

It's better here than in github pages. Add the `now` endpoints as well
as some design plans for future endpoints.