You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
On your homepage you talk about "OpenAPI" when I think you mean "an open API", which is a little confusing because it seems like you do also use "OpenAPI" somewhere, but hide the source YAML and publish a HTML rendering of it? Minefield! :D
Two things that would help any further confusion here:
Could you change the marketing copy to say "open API" so people know you just mean a public API?
Could you have a look at some of the modern OpenAPI-based doc tools like Stoplight Elements or ReDoc? They're open source and will convert your YAML > Widdershins > MD > HTML pipeline into "YAML is read and turned into HTML" which doesn't even need a build step.
LMK if you want any help with any of it.
The text was updated successfully, but these errors were encountered:
Adding the source yaml to the repo would also help people contribute pull requests, e.g fixing issues in current code samples, or adding new languages for them.
Hello! Thanks for making this API.
On your homepage you talk about "OpenAPI" when I think you mean "an open API", which is a little confusing because it seems like you do also use "OpenAPI" somewhere, but hide the source YAML and publish a HTML rendering of it? Minefield! :D
Two things that would help any further confusion here:
Could you change the marketing copy to say "open API" so people know you just mean a public API?
Could you have a look at some of the modern OpenAPI-based doc tools like Stoplight Elements or ReDoc? They're open source and will convert your YAML > Widdershins > MD > HTML pipeline into "YAML is read and turned into HTML" which doesn't even need a build step.
LMK if you want any help with any of it.
The text was updated successfully, but these errors were encountered: