improved schemas.
added oauth2 section
sorted lists
linking schemas of responses
Merge pull request #5 from michaelwittig/richer

improved schemas.