Create schema
Add an id to schema
Extract resources definition
Define the other top level attrs
Add top level links object
id can only been a string since #209
Add a brief faq about the json schema
Merge pull request #218 from kjg/gh-pages

Supply a json-schema of the json-api