Redocly/redoc

Description of array items is not appeared on response.

オープン

#1,179 opened on 2020/02/19

 (3 件のコメント) (13 件のリアクション) (0 人の担当者)TypeScript (2,272 件のフォーク)batch import
Type: Enhancementhelp wanted

Repository metrics

Stars
 (21,877 個のスター)
PR merge metrics
 (PR metrics pending)

説明

I found that UI would not show the description of items with the referenced schema.

I think this had mentioned In #538, but not fixed?

What swagger-UI showed:

What redoc showed, which lack of description "bar schema description.":

I test it with redoc-cli version 0.9.4, and the example YAML:

openapi: "3.0.0"
info:
  title: test
  version: "0.0.0"
paths:
  /foo:
    get:
      summary: foo
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                description: array of bars
                type: array
                items:
                  $ref: "#/components/schemas/bar"
components:
  schemas:
    bar:
      description: bar schema description.
      type: object
      properties:
        name:
          type: string

コントリビューターガイド