title: OpenAPI 3.0 - How to avoid adding "value" key when including examples by ref
body: <p>With OpenAPI Is there a way to include examples by reference with the $ref: tag that doesn't not require adding the "value" key?</p>
  
  <p>See examples I've added to the petstore.yaml:</p>
  
  <pre><code>openapi: "3.0.0"
  info:
    version: 1.0.0
    title: Swagger Petstore
    license:
      name: MIT
  servers:
    - url: http://petstore.swagger.io/v1
  paths:
  
    /pets:
      get:
        summary: List all pets
        operationId: listPets
        tags:
          - pets
        parameters:
          - name: limit
            in: query
            description: How many items to return at one time (max 100)
            required: false
            schema:
              type: integer
              format: int32
        responses:
          '200':
            description: A paged array of pets
            headers:
              x-next:
                description: A link to the next page of responses
                schema:
                  type: string
            content:
              application/json:    
                schema:
                  $ref: "#/components/schemas/Pets"
                example:
                  $ref: "#/components/examples/animals"
  
          default:
            description: unexpected error
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/Error"
      post:
        summary: Create a pet
        operationId: createPets
        tags:
          - pets
        responses:
          '201':
            description: Null response
          default:
            description: unexpected error
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/Error"
  
    /pets/{petId}:
      get:
        summary: Info for a specific pet
        operationId: showPetById
        tags:
          - pets
        parameters:
          - name: petId
            in: path
            required: true
            description: The id of the pet to retrieve
            schema:
              type: string
        responses:
          '200':
            description: Expected response to a valid request
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/Pet"
                example:
                  $ref: "#/components/examples/garfield"
          default:
            description: unexpected error
            content:
              application/json:
                schema:
                  $ref: "#/components/schemas/Error"
  
  components:
    schemas:
      Pet:
        type: object
        required:
          - id
          - name
        properties:
          id:
            type: integer
            format: int64
          name:
            type: string
          tag:
            type: string
  
      Pets:
        type: array
        items:
          $ref: "#/components/schemas/Pet"
  
      Error:
        type: object
        required:
          - code
          - message
        properties:
          code:
            type: integer
            format: int32
          message:
            type: string
  
    examples:
      garfield:
        id: 1
        name: garfield
        tag: cat
      grumpycat:
        id: 2
        name: grumpycat
        tag: cat
      odie:
        id: 3
        name: odie
        tag: dog
      animals:
        - $ref: "#/components/examples/garfield"
        - $ref: "#/components/examples/grumpycat"
        - $ref: "#/components/examples/odie"
  </code></pre>
  
  <p>openapi-generator-cli validate says it's invalid OpenAPI as does my OpenAPI plugin for VSCode. Error log output:</p>
  
  <pre><code>Validating spec (/local/petstore.yaml)
  Errors:
      -attribute components.examples.odie.name is unexpected
      -attribute components.examples.garfield.id is unexpected
      -attribute components.examples.grumpycat.name is unexpected
      -attribute components.examples.animals is not of type `object`
      -attribute components.examples.garfield.tag is unexpected
      -attribute components.examples.garfield.name is unexpected
      -attribute components.examples.odie.tag is unexpected
      -attribute components.examples.grumpycat.id is unexpected
      -attribute components.examples.grumpycat.tag is unexpected
      -attribute components.examples.odie.id is unexpected
  </code></pre>
  
  <p>[error] Spec has 10 errors.</p>
  
  <p>I can correct the errors by adding a value key like this:</p>
  
  <pre><code>  examples:
      garfield:
        value:
          id: 1
          name: garfield
          tag: cat
      grumpycat:
        value:
          id: 2
          name: grumpycat
          tag: cat
      odie:
        value:
          id: 3
          name: odie
          tag: dog
      animals:
        value:
          - $ref: "#/components/examples/garfield"
          - $ref: "#/components/examples/grumpycat"
          - $ref: "#/components/examples/odie"
  </code></pre>
  
  <p>The problem with this is that, my examples now include the value property, which I don't want as it's not part of the schema:</p>
  
  <pre><code>{
      "value": {
          "id": 1,
          "name": "garfield",
          "tag": "cat"
      }
  }
  </code></pre>
  
  <p>Question: Is there a way for me to define the examples by $ref as I have done WITHOUT using introducing the "value" property?</p>