-
Notifications
You must be signed in to change notification settings - Fork 9.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add example before the specification #2034
Comments
@fulldecent - I guess you need to take a look at https://petstore.swagger.io/ to understand what OpenAPI specification looks like once you use them. |
Proposed fix at #2299 |
I think we could signpost the (newer than this issue) resources at https://learn.openapis.org to support this request. |
PR for the part of this warranting a spec change is merged for 3.0.4 and ported to 3.1.1 via PR #3921! |
Regarding the OpenAPI homepage.
The specification goes directly into grammar and details. But nobody has shown me what the OpenAPI specification looks like. An example text file/device/robot/planet/other thing which complies with the specification should be shown as a specimen to explain what OpenAPI is.
The text was updated successfully, but these errors were encountered: