doctrine-expressive-example icon indicating copy to clipboard operation
doctrine-expressive-example copied to clipboard

init work on open api spec

Open matthewtrask opened this issue 5 years ago • 4 comments

WIP

matthewtrask avatar Feb 27 '19 14:02 matthewtrask

@adamculp initial work on OpenAPI spec. Don't merge yet, still need to set up a few things to get you going.

matthewtrask avatar Feb 27 '19 14:02 matthewtrask

@adamculp take a look at this when you get a second and let me know if it all makes sense so far, or if you have questions.

matthewtrask avatar Mar 18 '19 13:03 matthewtrask

@matthewtrask The use of int32 caught my eye. Will look at that more. Also, according to https://swagger.io/specification/ the uuid would get a 'type' but not necessarily a 'format', though in some later examples on that page it does show the usage of 'format' as well.

Otherwise, I think everything makes sense. Will peek a little more later, and see if I notice anything else.

Thank you!

adamculp avatar Mar 18 '19 13:03 adamculp

@adamculp yea some were guessing, like int32 but I just filled in the value so that there was an example there for you to follow along with. Ill go back through and spot check the types.

I was referencing this: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md

matthewtrask avatar Mar 18 '19 14:03 matthewtrask