Update README.md

Adds some description of how to use schema and RAML in our SOA