+1 to wardi suggestions.

I'd quite like the schema for this file to be stored with the file, rather than in the docs. Could be a comment in the JSON, e.g.: http://stackoverflow.com/questions/244777/can-i-comment-a-json-file

Either that, or consider using CSV which has column titles.