title: How can one split API documentation in multiple files using Swagger 2.0
body: <p>According to Swagger 2.0 specs, it might be possible to do this. I am referencing PathObject using $ref which points to another file. We used to be able to do this nicely using Swagger 1.2. But Swagger-UI does not seem to be able to read the referred PathObject in another file.</p>
  
  <p>Is this part of spec too new and is not yet supported? Is there a way to split each "path"'s documentation into another file?</p>
  
  <pre><code>{
      "swagger": "2.0",
      "basePath": "/rest/json",
      "schemes": [
          "http",
          "https"
      ],
      "info": {
          "title": "REST APIs",
          "description": "desc",
          "version": "1.0"
      },
      "paths": {
          "/time": {
              "$ref": "anotherfile.json"
          }
      }
  }
  </code></pre>