title: Specify description for every response we have in Apiary.io
body: <p>Is it possible to specify description for every response to some request? Suppose, we have a request</p>
  
  <pre><code>### Retrieve resource [GET]
  
      + Headers
  
              If-None-Match: "Version1"
  </code></pre>
  
  <p>And 2 responses</p>
  
  <pre><code>+ Response 200 (application/xml)
  
      + Headers
  
              ETag: "Version2"
  
      + Body
  
              &lt;Xml&gt;
                  &lt;A&gt;
                      &lt;B /&gt;
                      &lt;C /&gt;
                  &lt;/A&gt;
              &lt;/Xml&gt;
  
  + Response 304 (application/xml)
  </code></pre>
  
  <p>What I would like is to specify description like here (please note comments right under <code>+ Response</code> lines):</p>
  
  <pre><code>+ Response 200 (application/xml)
  In case if the resource hasn't changed
  
      + Headers
  
              ETag: "Version2"
  
      + Body
  
              &lt;Xml&gt;
                  &lt;A&gt;
                      &lt;B /&gt;
                      &lt;C /&gt;
                  &lt;/A&gt;
              &lt;/Xml&gt;
  
  + Response 304 (application/xml)
  In case if the resource has changed
  </code></pre>
  
  <p>Is it possible?</p>