swagger-ui #3417

gistfile1.txt

swagger: "2.0"
info:
  version: "1"
  title: "CRUD"
  description: "demonstrate Swagger UI bug (model schemas repeated; wrong description)"
basePath: "/crud"
schemes:
- "http"
paths:

definitions:
  createModel:
    title: "Create Model"
    description: "The representation used to create a new model."
    properties:
      name:
        type: "string"
  updateModel:
    title: "Update Model"
    description: "The representation used to update a model."
    allOf:
    - $ref: "#/definitions/createModel"
    - type: "object"
      properties:
        id:
          type: "string"
          description: "The unique identifier for the model."
        name:
          type: "string"
          description: "The name of the model."
        description:
          type: "string"
          description: "The description of the model."
        version:
          type: "integer"
          format: "int32"
          description: "The version number of the model representation."
    required:
    - "id"
  model:
    title: "Model"
    description: "The representation of a model."
    allOf:
    - $ref: "#/definitions/updateModel"
    - type: "object"
      properties:
        createdBy:
          type: "string"
          description: "The user who created the model."
        modifiedBy:
          type: "string"
          description: "The user who most recently modified the model."
        creationTimeStamp:
          type: "string"
          description: "The time stamp in `YYYY-MM-DDThh:mm:ss.sssZ` format when the\
            \ model was created."
          format: "date-time"
        modifiedTimeStamp:
          type: "string"
          description: "The time stamp in `YYYY-MM-DDThh:mm:ss.sssZ` format when the\
            \ model was last modified."
          format: "date-time"
  modelCollection:
    title: "Model Summary Collection"
    description: "A collection of model representations."
    allOf:
    - $ref: "#/definitions/baseCollection2"
    - type: "object"
      properties:
        items:
          type: "array"
          items:
            $ref: "#/definitions/model"
          description: "The array of  representations."
  baseCollection2:
    title: "Base collection"
    description: "This is a base schema used to define paginated collections of resources.\
      \ This base schema is extended by other schemas in APIs by adding an 'items'\
      \ array property. These extensions define the application/vnd.sas.collection\
      \ media type (version 2)"
    properties:
      name:
        type: "string"
        description: "The name of the collection."
      start:
        type: "integer"
        description: "The zero-based index of the first item in the collection."
        format: "int64"
      limit:
        type: "integer"
        description: "The number of items that were requested for the collection."
      count:
        type: "integer"
        description: "The number of items in the collection."
        format: "int64"
      accept:
        type: "string"
        description: "A space-delimited list of media types from which an `Accept`\
          \ header may be constructed."
      version:
        type: "integer"
        description: "The version number of the collection representation. This representation\
          \ is version 2."