title: How to link to another endpoint in Swagger
body: <p>I'm writing a Swagger specification for an future public API that requires a very detailed and clean documentation. <strong>Is there a way to reference/link/point to another endpoint at some other location in the <em>swagger.yml</em> file?</strong></p>
  
  <p>For example, here is what I am trying to achieve:</p>
  
  <pre><code>paths:
    /my/endpoint:
      post:
        tags:
          - Some tag
        summary: Do things
        description: &gt;
          This endpoint does things.
          See /my/otherEndpoint for stuff  # Here I would like to have some kind of hyperlink
        operationId: doThings
        consumes:
          - application/json
        produces:
          - application/json
        parameters:
          ...
        responses:
          ...
    /my/otherEndpoint:  # This is the endpoint to be referenced to
      get:
        ...
  </code></pre>
  
  <p>I have found that <code>$ref</code> does not help because it simply replaces itself with the contents of the reference.</p>
  
  <p>Can Swagger do such a thing?</p>