Skip to content

Issue referencing official 2020-12 json meta-schema #2158

@BTOdell

Description

@BTOdell

Describe the bug
I am referencing the official 2020-12 JSON meta-schema in my OpenAPI 3.1 spec:

type: object
properties:
  name:
    type: string
  configSchema:
    $ref: "https://json-schema.org/draft/2020-12/schema"
  inputSchema:
    $ref: "https://json-schema.org/draft/2020-12/schema"
  outputSchema:
    $ref: "https://json-schema.org/draft/2020-12/schema"

I would expect this to render in some meaningful way with the Redoc UI, but this is what I get:

image

As I understand it, OpenAPI 3.1 is a superset of the 2020-12 JSON Schema specification, so this should work without issue. I see that there are still some on-going issues with full 3.1 support, so maybe there is a simple explanation why this isn't working.

Expected behavior

I would expect the redoc tool to render inline documentation for the official JSON Schema spec, or at least provide a link to external documentation (maybe using the $vocabulary links embedded in the spec?).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions