title: Provide 'Example Value' for swagger.yaml object with optional fields
body: <p>I am trying to provide more description in the 'Model' tab and example values in the  'Example Value' tab for a swagger.yaml object with optional objects</p>
  
  <p>My model to be used by my PATCH request (RestAPI) is defined like so in my swagger.yaml:</p>
  
  <pre><code>  mymodel:
      items:  
        - $ref: '#/definitions/modelHeader'
        - $ref: '#/definitions/modelPayload'
  </code></pre>
  
  <p>Currently mymodel has
  'Model' as "mymodel {}" and 'Example Value' as "{}"</p>
  
  <p>modelHeader and modelPayload are composite objects with examples defined.
  Even though mymodel does not mandate any field, I want it to display these optional fields with examples.</p>
  
  <p>I know I can define a minimal the example like so         <code>example: [{name: 'myname', value: 'myvalue1'},{name: 'myname2', value: 'myvalue2'}]</code></p>
  
  <p>But that is cumbersome and still does not populate 'Model'.
  Is it possible to provide a url to a json as an example?</p>
  
  <p>Any hints or ideas would be appreciated. I am still new to YAML specification</p>