How to provide example value to a Response Body of content-type: text/html in Swagger (to test with dredd)
<p>I have an API call which responds 200 OK and returns an HTML. I would like to add this to my API documentation
(especially since i validate it using dredd and unless i provide it with the expected response body the test fails). How
would i do this in Swagger?</p>

<p>--- More details ---
My Response to an API call is 200 OK and with a one line Response Body:</p>

<p><code>&lt;html&gt;&lt;body&gt;You are being &lt;a href="https://my.domain.com/users/sign_in"&gt;redirected&lt;/a&gt;.&lt;/body&gt;&lt;/html&gt;</code></p>

<p>I can easily define the Response Body in Blueprint in the following form:</p>

<pre><code> + Response 302 (text/html; charset=utf-8)

     + Body

         `&lt;html&gt;&lt;body&gt;You are being &lt;a href="https://my.domain.com/users/sign_in"&gt;redirected&lt;/a&gt;.&lt;/body&gt;&lt;/html&gt;`
</code></pre>

<p>But i'm not sure how to do this in Swagger. Almost all examples i can find are for application/json responses (understandably) and i'm having trouble
guessing the correct syntax for this kind of response.</p>

<p>The relevant swagger text in my document is this (so far without specifying the response body, so with an empty body dredd
fails because the response body should be <code>&lt;html&gt;&lt;body&gt;You are being &lt;a href="https://my.domain.com/users/sign_in"&gt;redirected&lt;/a&gt;.&lt;/body&gt;&lt;/html&gt;</code>):</p>

<pre><code># this is my API spec in YAML
swagger: '2.0'
info:
  title: My API (Swagger)
  description: blablabla
  version: "1.0.0"
# the domain of the service
host: my.domain.com
# array of all schemes that your API supports
schemes:
  - https
# will be prefixed to all paths
basePath: /
produces:
  - application/json; charset=utf-8
paths:
  /users/password:
    post:
      summary: Password Reset
      description: |
        Handles Reset password for existing user.
      consumes:
        - application/x-www-form-urlencoded
      produces:
        - text/html; charset=utf-8
      parameters:
        - name: "user[email]"
          description: email
          in: formData
          required: true
          type: string
          default: "user@gmail.com"
      tags:
        - Reset Password
      responses:
        200:
          description: Success
</code></pre>

<p>Please comment if you have any suggestions on this. Thanks!</p>