Adam Altman

> With all due respect, you could do a PR or a commit to the main branch and then release a new minor version (ie 0.11.1 or 0.11.2) if you...

On number 3 (links), is this label okay:

And check it covers the `plugins` paths too.

Maybe the decorator could remove a list of properties. This would be common as sometimes people need to mark up their OpenAPI with proxy-related specification extensions: [see an example `x-amazon-apigateway-...`](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html).

I agree with simplifying if possible. Flattening the subject may be fine. Those properties (`filterInParentKeys`, `filterOutParentKeys`, `matchParentKeys`) shouldn't be mutually exclusive, and people should be aware they could create nonsense...

I'm not sure about the `do` word. I feel it is used in combination with `while` and introduces the same confusion as `if` without `else`.

There is a language Gherkin (used for describing behavior) which used the keywords `Given`, `When`, `Then`. I'm not saying this because those keywords make sense in our system (they don't...

I reworked it more and decided to open it as a separate PR: https://github.com/Redocly/redocly-cli/pull/917

@ArtFlag the version won't display if you change your version to an empty string, for example. https://redocly.com/docs/openapi-visual-reference/info/#version-examples You can set the version as an empty string pro grammatically by using...

Let's do it then.