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
{{ message }}
This repository has been archived by the owner on Jul 2, 2019. It is now read-only.
Issue #112 asks for x-nullable, but this asks for another feature.
Dropping requirement for the vendor prefix of x-nullable and x-example.
Currently I can either use Dredd or ReDoc, I cannot use both. If I use example: stuff for foo property, then ReDoc will render it, but Dredd will error due to unexpected property.
When I switch to using x-example, ReDoc will fail and default to shoving string into the examples, making humans sad reading the docs.
I'm trying to write a PR for x-example support in ReDoc as they already have an issue for it, but... double attack.
The text was updated successfully, but these errors were encountered:
The reason the Swagger adapter (and in turn Dredd) will produce an error, is because the example keyword is not permitted in this area in the Swagger specification.
RE ReDoc: Already trying to PR them but getting stuck on the first step. Redocly/redoc#304
As for following the spec exactly: I figured that would be the case. Some folks use OpenAPI Sampler to backport some of these OpenAPI v3.0 features into their v2.0 tooling. This helps alleviate the pain of required stuff being in v3.0 and not in v2.0, and stops everything being almost useless in the mean time.
That said, v3.0 is so close, I'll just keep going with the ReDoc approach. Thank you.
Seems that ReDoc is adding support for x-example (Redocly/redoc#186 (comment)), we have #112 to track adding x-nullable support. I think we can close this issue.
Issue #112 asks for
x-nullable
, but this asks for another feature.Dropping requirement for the vendor prefix of
x-nullable
andx-example
.Currently I can either use Dredd or ReDoc, I cannot use both. If I use
example: stuff
forfoo
property, then ReDoc will render it, but Dredd will error due to unexpected property.When I switch to using
x-example
, ReDoc will fail and default to shovingstring
into the examples, making humans sad reading the docs.I'm trying to write a PR for
x-example
support in ReDoc as they already have an issue for it, but... double attack.The text was updated successfully, but these errors were encountered: