DOC: expand JSON docs