DOC: expand JSON docs
Merge pull request #5287 from Komnomnomnom/json-docs

DOC: expand JSON docs