update README.md with .json doc.

More could be spelled out, but I tried to keep this first version short.  It can always be expanded if there are common questions.