Showcasing ref resolving in Redocly CLI

Preparation

Make sure you have the redocly cli installed.

Run demonstration

openapi.yaml contains a OpenAPI spec that references a schema in schemas.yaml. One can bundle the spec and the schema into a single file by executing:

redocly bundle openapi.yaml -o bundled.yaml

The bundled.yaml will contain the referenced schema in the components section of the OpenAPI spec so that tools can still use the original schema name.