search

OAI / learn.openapis.org

OpenAPI - Getting started, and the specification explained
https://learn.openapis.org/
Creative Commons Attribution 4.0 International
112 stars 56 forks source link

Need better examples #96

Open c094728 opened 2 years ago

c094728 commented 2 years ago

I am looking for a reference api that contains every feature of the spec so I can test a publishing tool we have developed i.e. links, discriminators, $refs , schemas, etc. For example I do not find any api in the examples section of code that contains discriminators . Does the spec have a complete reference api?

lornajane commented 6 months ago

It doesn't, but I think this is a good idea and we can build things up over time, perhaps by asking people to donate examples! However, that content would live on https://learn.openapis.org, so I'm going to suggest that we relocate this issue to that repository.

@darrelmiller could you relocate this issue to the learn repo please? (I don't think anyone else has enough access)

handrews commented 6 months ago

@lornajane you (and all maintainters) should have transfer access now, I worked it out with Ron recently. I can see the learn repo in the "transfer issue" section you can get to in the lower right of the screen. If you can't, we should tag Ron to get him to figure out why.