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”