title: Grails 3.1.4 Project with Swagger Documentation
body: <h1>Description</h1>
  
  <p>I am working with <strong>Grails 3.1.4</strong> and I am having problems documenting my Controller classes with the <strong>Swagger Api</strong>.</p>
  
  <p><code>grails -version</code> gives me this output:</p>
  
  <pre><code>| Grails Version: 3.1.4
  | Groovy Version: 2.4.6
  | JVM Version: 1.8.0_73
  </code></pre>
  
  <p>I tried to integrate Swagger into the project using these sources:<br/>
   - <a href="https://grails.org/plugin/swaggydoc" rel="nofollow">https://grails.org/plugin/swaggydoc</a> <br/>
   - <a href="https://rahulsom.github.io/swaggydoc/" rel="nofollow">https://rahulsom.github.io/swaggydoc/</a></p>
  
  <h2>According to these sources I have to do the following things:</h2>
  
  <h3>1. Add dependencies to <code>build.gradle</code>:</h3>
  
  <pre><code>compile 'io.swagger:swagger-core:1.5.7'
  compile 'io.swagger:swagger-jaxrs:1.5.7'
  compile "com.github.rahulsom:swaggydoc-commons:0.24.0"
  compile "org.grails.plugins:swaggydoc:0.27.0"
  </code></pre>
  
  <h3>2. Add another repository to <code>build.gradle</code>:<br/></h3>
  
  <pre><code>`jcenter()`
  </code></pre>
  
  <h3>3. Annotate my Controller in the following fashion:</h3>
  
  <pre><code>@Api(value = "myValue", description = "this controller does something")
  @Path("/myapproot/myDomainClassX")
  MyDomainClassXController{
      @GET
      @Path("/myFunction")
      def myFunction(){
          render "MyDomainClassXController, myFunction(), did something"
      }
  }
  </code></pre>
  
  <h3>4. In the file <code>application.yml</code> I added:</h3>
  
  <pre><code>grails:
      mime:
          disable:
              accept:
                  header:
                      userAgents: []
  </code></pre>
  
  <h3>5. The aforementioned sources write about a <code>Config.groovy</code> which I do not have, so instead of writing:</h3>
  
  <pre><code>swaggydoc {
      contact = "developer@coer.com"
      description = "API description"
      title = "My Swagger Doc for my awesome project"
      apiVersion = "0.2cents"
  }
  </code></pre>
  
  <h3>6. into the non-existent <code>Config.groovy</code>, I added the same text into the file <code>application.yml</code> using the yml syntax:</h3>
  
  <pre><code>swaggydoc:
      contact: "developer@coder.com"
      description: "API Description"
      title: "My Swagger Doc for my awesome project"
      apiVersion: "0.2cents"
  </code></pre>
  
  <h1>Result</h1>
  
  <h3>What works is:</h3>
  
  <p>I am running my Grails application with the <code>bootRun</code> task and browse to <code>http://localhost:8080/myapproot/myDomainClassX/myFunction</code> and see the String "MyDomainClassXController, myFunction(), did something" in my browser.</p>
  
  <h3>What not works is:</h3>
  
  <p>When I browse to <code>http://localhost:8080/myapproot/api</code> I get the <strong>"Page Not Found (404)" Error</strong>. Here i expected to see the magic of the Swagger annotations producing a documentation.</p>
  
  <h1>Question</h1>
  
  <p>What did I do wrong in the configuration of the Swagger plugin mentioned in the sources?</p>