title: Swagger: where to provide sample json for a call?
body: <p>I'm new to swagger and I'm trying to start documenting an API. I'd like to include examples of requests/responses in my documentation, not just the schema definition itself. </p>
  
  <p>There is an "examples" feature on the responses object, however, when I fill this out, it does not show up anywhere in the generated documentation. Is this just a missing feature from swagger for the time being, or am I using this feature incorrectly?</p>
  
  <p>Here is my spec (I am aware I haven't implemented security properly yet):</p>
  
  <pre><code>swagger: '2.0'
  schemes: ['https']
  info:
    version: 1.0.0.0
    title: 'Test API'
    contact:
      name: Support
      url: 'www.nowhere.com'
      email: 'test@example.com'
  consumes: ['application/json']
  produces: ['application/json']
  paths:
    /Variables:
      get:
        summary: 
          Returns the list of all variables in the system.
        description:
          Returns the list of all variables in the system.
        tags: ['Variables']
        consumes: ['application/json']
        produces: ['application/json']
        parameters:
          - name: "Authorization"
            in: header
            description: "Provide the OAuth access token in the format of: Bearer token_value"
            type: string
        responses:
          '200':
            description: Successful response
            schema:
              $ref: '#/definitions/Variables'
            examples:
              application/json:
                VariableToken: Name
                VariableGroupName: Main
                DataType: text
                VariableDisplayName: Name
  definitions:
    Variables:
      type: array
      items:
        title: Variable
        type: object
        properties:
          VariableToken:
            type: string
            format: string
          VariableGroupName:
            type: string
            format: string
          DataType:
            type: string
            format: string
          VariableDisplayName:
            type: string
            format: string
  </code></pre>