Could you extend the README a little?

[philsturgeon]

Hey there! This looks great, and it's really exciting to see an OpenAPI v3 parser for Go, but could you consider adding a little more to the README so folks can see how it works?

[nkev]

@philsturgeon Have a look at this one too: https://github.com/getkin/kin-openapi It's been around for a while (recently been moved to it's own repo).

[philsturgeon]

Thanks! Yeah I spotted that one shortly after, I’m evaluating the options. :) How do the two differ in functionality or goals?

…

-- Phil Sturgeon @philsturgeon

On Jul 23, 2018, at 19:56, Nuri ***@***.***> wrote: @philsturgeon Have a look at this one too: https://github.com/getkin/kin-openapi It's been around for a while (recently been moved to it's own repo). — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

[nkev]

This one is more lightweight and has a clear focus, while the kin-openapi has more functionality. If you need protobuf-openapi interoperability, also have a look at Google's https://github.com/googleapis/gnostic

[morlay]

hi @philsturgeon
go doc have some example https://godoc.org/github.com/go-courier/oas#OpenAPI

I used this pkg for my framework courier to pick openapi spec from code.
https://github.com/go-courier/httptransport/tree/master/openapi/generator
https://github.com/go-courier/httptransport/tree/master/__examples__

I will add doc for each exposes after whole framework stable enough.