title: How to add two different paths to the same endpoint in swagger?
body: <p>Using javaws we can have multiple endpoints leading to the same method. Example:</p>
  <pre class="lang-java prettyprint-override"><code>@Path(&quot;/menus&quot;)
  public class MenuResource {
      @Path(&quot;/{menuId}/sections&quot;)
      @Timed @ExceptionMetered
      public MenuSectionResource getSections(@InjectParam MenuSectionResource resource) {
          return resource;
      }
  }
  
  @Path(&quot;/sections&quot;)
  public class MenuSectionResource {
      @GET
      public Section get(@PathParam(&quot;menuId&quot;) String menuId, @QueryParam(&quot;id&quot;) String id) {
          /// method accessed by GET in /sections or GET in /menus/{menuid}/sections
      }
  }
  </code></pre>
  <p>I'm trying to use swagger to document both endpoints, but i can only use one
  <code>@Api</code> annotation in each class, so i can generate either <code>/sections</code> or <code>/menus/{menuid}/sections</code>. Is it possible to automatically generate both entries in the swagger.json output?</p>