title: Describing URI parameters in RAML
body: <p>I'm declaring a REST service API stub in <strong>RAML</strong>. My web application provides equipment, which can be listed, obtained by id or by code. When I want the whole list, I don't specify any URI parameter, however, to get a concrete equipment, I do. That's its current state:</p>
  
  <pre class="lang-none prettyprint-override"><code>/equipment:
      get:
        body:
          application/json:
          application/xml:
      description:
        List all the equipment
      /id/{equipmentId}:
        get:
           body:
            application/json:
            application/xml:
        description:
          Get an equipment by id 
      /code/{code}:
          get:
            body:
              application/json:
              application/xml:
          description: 
                Get an equipment by code
  </code></pre>
  
  <p>Here, in <code>description</code> fields I write what the current call performs. However, I would like to add a description for the parameter passed in the URI itself (<code>id</code> or <code>code</code>). Is there a way to achieve it?</p>