redocly-cli
redocly-cli copied to clipboard
Redocly
⚒️ Redocly CLI makes OpenAPI easy. Lint/validate to any standard, generate beautiful docs, and more.
https://github.com/Redocly/redocly-cli/blob/f11ebcbe1349c5593fbd40ca14259ff432a04b5a/packages/core/src/typings/openapi.ts#L160-L164 https://github.com/Redocly/redocly-cli/blob/f11ebcbe1349c5593fbd40ca14259ff432a04b5a/packages/core/src/types/oas3_1.ts#L90-L185 Should these two separate typings be refactored to use only one of them across the core package? The `openapi.ts` typing does not include the `unevaluated*` keywords required for...
**Describe the bug** Are we missing `const` from here: https://github.com/Redocly/redocly-cli/blob/main/packages/core/src/typings/openapi.ts - https://json-schema.org/understanding-json-schema/reference/const **To Reproduce** n/a **Expected behavior** To be able to use the type tree to traverse the values including...
**Describe the bug** For OAS 3.1, arbitrary keywords within schemas produce lint errors. This contradicts the 3.1 specification. **To Reproduce** Using `minimal`, [this example spec](https://github.com/OAI/OpenAPI-Specification/blob/main/tests/v3.1/pass/mega.yaml) from OpenAPI fails linting when...
**Describe the bug** I found an impossible `oneOf` definition. I'm constantly trying to educate people about `oneOf` vs `anyOf`. In any case, it would be better if the lint tool...
**Describe the bug** It seems that any remote `$ref` that includes a query parameter cannot be resolved correctly. **To Reproduce** Steps to reproduce the behavior: 1. Clone this repo: https://github.com/vernondegoede/repo2-with-specs...
**Is your feature request related to a problem? Please describe.** I am using redocly to generate the lint report to see warnings in an azure devops pipeline. I would like...
Any scheme used via ``` type: array items: $ref: some-reference ``` will be removed if `--remove-unused-components` flag is used in the `redocly bundle` command. Same spec with workaround ``` type:...
I'm a new user reading the [documentation](https://redocly.com/docs/) for the first time. I don't understand the relationship between - [redoc](https://www.npmjs.com/package/redoc) - [redoc-cli](https://www.npmjs.com/package/redoc-cli) - [@redocly-cli](https://www.npmjs.com/package/@redocly/cli) Are some of these deprecated? `redoc` says...
We have a guide for replacing the server details, but it is outdated. We'd love to get some help with: - [ ] updating the copy to explain why each...
The [Redocly CLI Quickstart guide](https://redocly.com/docs/cli/quickstart) has not been updated in quite some time. Could we please: - [ ] check the existing instructions still work - [ ] improve the...