title: How to describe JSON data in a spec?
body: <p>What is the best way to describe JSON data in a spec?</p>
  
  <p>In the past I've used examples with 'wordy' descriptions, but it feels imprecise.  </p>
  
  <p>There seems to be a nascent <a href="http://json-schema.org/" rel="noreferrer">JSON schema</a> standard, but it doesn't look like a hugely active project.  Any other ways?</p>
  
  <hr>
  
  <p>(<strong>Update</strong>) After thinking about this for several days I like bmargulies suggestion around using a conversion convention.  Since the JSON documents in this case our coming out of .NET web services I am going to simply document the schema with C# class syntax.  This may not be totally rigourous, but everyone involved will understand it and coupled with the examples will get the message across as quickly as possible.</p>