modify example in spec to be 0.13 valid
Merge pull request #5 from picsoung/picsoung

modify example in spec to be 0.13 valid
Overhaul based on comments from Gluecon, APIDays

Revised version based on comments from OriPekelman, Mike Amundsen, Jerome Louvel, Kirsten Hunter, Mehdi Medjaoui, John Musser and many others. Primary Changes: 

Changes in this version. 

 * Versioning Identifier to the file which identifies which version of the APIs.json spec the file uses.
 * Adding version element to the API document
 * Adding a “created” date to the file.
 * Define and register a media type (e.g. apis.json)
 * Extracting the reserved words list to a separate web page.
 * Decision to make links as explicit as possible and to group them: 
	- human URL and 
 * Decision that meta should be removed: the whole file is effectively meta.
 * Removed encodings other than JSON.
 * List items have become enums
 * APIs collection is optional, since a file may just be includes.

 * removed machineURL and added baseUrl
 * changed “URLs” to “Properties”
 * Adopted vCard labels for data about individuals.

In progress to support this version:

 * Make a JSON schema.
 * Changing names / tokens to align with existing HTML/W3C Labels (in progress), e.g. Image to 
   Icon.

Slated for next version.

 * Consider registering a “well known” location of it [mid term]
 * Consider adopting an existing link relation or creating a new one - e.g. “described-by”
Fixed a few typos
Attempted to make example consistent with specification
Fixed some JSON syntax errors
Merge branch 'darrelmiller-master'
added validations
changed tags to an array, added pattern property to urls type
updated the schema to use a fixed set of tags, allowing X-* as prefix, and added descriptions to all references
additional properties should be formatted X-something
Merge pull request #48 from picsoung/picsoung-master

Allow additional properties, but formatted X-something
draft schema for 0.14