Update docs to reflect new JSON philosophy