Need better examples

[c094728]

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]

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]

@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.