deliveryhero / serverless-aws-documentation

Serverless 1.0 plugin to add documentation and models to the serverless generated API Gateway
MIT License
309 stars 148 forks source link

Documentation should specify to only utilize JSON Schema v 4 #116

Open djakaitis opened 5 years ago

djakaitis commented 5 years ago

Currently API Gateway supports version 4 of the JSON schema spec. (see here:(https://docs.aws.amazon.com/apigateway/latest/developerguide/models-mappings.html).

Nothing in the current documentation explains this. As a result fields such as $id and examples are considered invalid on serverless deployment.

jonathanalberghini commented 5 years ago

What is or where is the documentation on submittedItems. I cannot find this anywhere? Thanks!!