Provide better RAML examples

Refactor existing examples to provide better examples.
Use petstore as an example of decent RAML examples.
Or examples from raml-apis for example https://github.com/raml-apis/Instagram or similar.

Pulled in 3 raml-api repositories as subtrees (no intention to push back to upstream repos).
AccuWeather and AmazonS3 as RAML 0.8
AdhereTech as RAML 1.0
Need another RAML 1.0 (Find Petstore?)