Schema Objects support an example attribute to provide a user friendly example of the request/response object.
It would be nice if the editor could render these in the UI somehow.
https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#schemaObject
e.g.
properties:
id:
type: integer
format: int64
name:
type: string
required:
- name
example:
name: Puma
id: 1