<div dir="ltr"><div class="gmail_extra">Thanks a lot to Yves!</div><div class="gmail_extra"><br></div><div class="gmail_extra">Matthias, I will send a PR this week :)<br></div><div class="gmail_extra"><br></div><div class="gmail_extra">Best, </div><div class="gmail_extra">Idel</div><div class="gmail_extra"><br><div class="gmail_quote">2015-04-09 11:14 GMT+03:00 Matthias Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Hi Yves,<div><br></div><div>thanks a lot!</div><div><br></div><div>Idel, below is the license key - I saw (looking at your Tika link) it needs to be included on the pom.xml file.</div><div><br></div><div>Cheers,</div><div>Matthias</div><div><br></div><div><br><div class="gmail_quote">---------- Forwarded message ----------<br>From: <b class="gmail_sendername">Yves Vandewoude</b> <span dir="ltr">&lt;<a href="mailto:yves.vandewoude@miredot.com" target="_blank">yves.vandewoude@miredot.com</a>&gt;</span><br>Date: Thu, Apr 9, 2015 at 10:07 AM<br>Subject: Re: License Key for AeroGear UnifiedPush Server (was: Re: [aerogear-dev] do we want swagger for REST endpoint documentation?)<br>To: Matthias Wessendorf &lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;<br><br><br>
  
    
  
  <div bgcolor="#FFFFFF" text="#000000">
    Hello Matthias,<br>
    <br>
    The licence key for the  AeroGear UnifiedPush Server project is:<br>
    <br>
&lt;licence&gt;cHJvamVjdHxvcmcuamJvc3MuYWVyb2dlYXIudW5pZmllZHB1c2gudW5pZmllZHB1c2gtamF4cnN8MjAxNy0wNS0wMXx0cnVlfC0xI01Dd0NGQitaa0VVRVlsaU9LQjljR2h5TWNSWm1VMTREQWhRbUlHOXY3MExCR0FoT2FubklFSER2SWl1OVZnPT0=&lt;/licence&gt;<br>
    <br>
    It is valid for two years (until May 1st 2017) for
    org.jboss.aerogear.unifiedpush / unifiedpush-jaxrs  <br>
    <br>
    After that, you are free to request a new licence key. <br>
    <br>
    We continuously aim to improve our tool, so do not hesitate to
    contact us if you have any questions or remarks. Support questions
    are best sent to <a href="mailto:support@miredot.com" target="_blank">support@miredot.com</a>, since they are dealt with by a
    team instead of just me :)<br>
    <br>
    Kind regards,<br>
    Yves<br>
    <br>
    <div>Matthias Wessendorf schreef op
      9/04/2015 om 9:46:<br>
    </div><div><div>
    <blockquote type="cite">
      <div dir="ltr">
        <div class="gmail_extra">Hi Miredot team,
          <div><br>
          </div>
          <div>for the AeroGear UnifiedPush Server ([1], [2]), we would
            like to start using miredot for our jaxrs endpoints ([3]).
            The Maven groupId is &quot;org.jboss.aerogear.unifiedpush&quot; and
            the artifactId is &quot;unifiedpush-jaxrs&quot;.</div>
          <div><br>
          </div>
          <div>Currently we are using jaxrs-doclet ([4]), but we are not
            happy with that.</div>
          <div><br>
          </div>
          <div>The Server is an OpenSource project with regular
            releases, and it is licensed under the Apache 2.0 license.</div>
          <div><br>
          </div>
          <div>For this project we would like to request an opensource
            license.</div>
          <div><br>
          </div>
          <div>Thanks,</div>
          <div>Matthias</div>
          <div><br>
          </div>
          <div>
            <div>[1] <a href="https://aerogear.org/push/#unifiedpush" target="_blank">https://aerogear.org/push/#unifiedpush</a></div>
            <div>[2] <a href="https://aerogear.org/docs/unifiedpush/ups_userguide/index/" target="_blank">https://aerogear.org/docs/unifiedpush/ups_userguide/index/</a></div>
            <div>[3] <a href="https://github.com/aerogear/aerogear-unifiedpush-server/tree/master/jaxrs" target="_blank">https://github.com/aerogear/aerogear-unifiedpush-server/tree/master/jaxrs</a></div>
          </div>
          <div>[4] <a href="https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/overview-index.html" target="_blank">https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/overview-index.html</a></div>
          <div><br>
          </div>
        </div>
        <div class="gmail_extra"><br>
        </div>
        <div class="gmail_extra"><br>
          <div class="gmail_quote">On Tue, Apr 7, 2015 at 1:57 PM, Idel
            Pivnitskiy <span dir="ltr">&lt;<a href="mailto:idel.pivnitskiy@gmail.com" target="_blank">idel.pivnitskiy@gmail.com</a>&gt;</span>
            wrote:<br>
            <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
              <div dir="ltr">Ok, so I will wait a license key from you.</div>
              <div>
                <div>
                  <div class="gmail_extra"><br>
                    <div class="gmail_quote">2015-04-07 14:55 GMT+03:00
                      Matthias Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br>
                      <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                        <div dir="ltr"><br>
                          <div class="gmail_extra"><br>
                            <div class="gmail_quote">
                              <div>
                                <div>On Tue, Apr 7, 2015 at 1:42 PM,
                                  Idel Pivnitskiy <span dir="ltr">&lt;<a href="mailto:idel.pivnitskiy@gmail.com" target="_blank">idel.pivnitskiy@gmail.com</a>&gt;</span>
                                  wrote:<br>
                                  <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                    <div dir="ltr">IMO, custom
                                      annotations force you to duplicate
                                      code and documentation. Take a
                                      look at a more detailed example:
                                      <div>
                                        <pre style="color:rgb(0,0,0)">  @POST
  @Path(&quot;/{petId}&quot;)
  @Consumes({MediaType.APPLICATION_FORM_URLENCODED})
  @ApiOperation(value = &quot;Updates a pet in the store with form data&quot;,
    consumes = MediaType.APPLICATION_FORM_URLENCODED)
  @ApiResponses(value = {
    @ApiResponse(code = 405, message = &quot;Invalid input&quot;)})
  public Response  updatePetWithForm (
   @ApiParam(value = &quot;ID of pet that needs to be updated&quot;, required = true)@PathParam(&quot;petId&quot;) String petId,
   @ApiParam(value = &quot;Updated name of the pet&quot;, required = false)@FormParam(&quot;name&quot;) String name,
   @ApiParam(value = &quot;Updated status of the pet&quot;, required = false)@FormParam(&quot;status&quot;) String status) {
    System.out.println(name);
    System.out.println(status);
    return Response.ok().entity(new com.wordnik.swagger.sample.model.ApiResponse(200, &quot;SUCCESS&quot;)).build();
  }</pre>
                                        <pre style="color:rgb(0,0,0)"></pre>
                                      </div>
                                      <div>It is much more simple with
                                        MireDot (also because javadoc
                                        could be generated automatically
                                        by IDE):</div>
                                      <div>
                                        <pre style="color:rgb(0,0,0)">  /**
  * Updates a pet in the store with form data.
  *
  * @param petId ID of pet that needs to be updated
  * @param name Updated name of the pet
  * @param status Updated status of the pet
  */
  @POST
  @Path(&quot;/{petId}&quot;)
  @Consumes({MediaType.APPLICATION_FORM_URLENCODED})
  public Response  updatePetWithForm (@PathParam(&quot;petId&quot;) String petId,
                                      @FormParam(&quot;name&quot;) String name,
                                      @FormParam(&quot;status&quot;) String status) {
    System.out.println(name);
    System.out.println(status);
    return Response.ok().entity(new com.wordnik.swagger.sample.model.ApiResponse(200, &quot;SUCCESS&quot;)).build();
  }</pre>
                                        <div class="gmail_extra">Really,
                                          I don&#39;t know why Swagger is so
                                          popular :)</div>
                                      </div>
                                    </div>
                                  </blockquote>
                                  <div><br>
                                  </div>
                                </div>
                              </div>
                              <div>That&#39;s quite a difference, and less
                                verbose and less of duplication (DRY).
                                So I&#39;d say, let&#39;s try Miredot :-) </div>
                              <div><br>
                              </div>
                              <div>Thanks for the valuable info, Idel!</div>
                              <span><font color="#888888">
                                  <div><br>
                                  </div>
                                  <div>-Matthias</div>
                                </font></span>
                              <div>
                                <div>
                                  <div> </div>
                                  <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                    <div dir="ltr">
                                      <div>
                                        <div>
                                          <div>
                                            <div class="gmail_extra"><br>
                                              <div class="gmail_quote">2015-04-07
                                                14:11 GMT+03:00 Matthias
                                                Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br>
                                                <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                  <div dir="ltr"><br>
                                                    <div class="gmail_extra"><br>
                                                      <div class="gmail_quote"><span>On
                                                          Tue, Apr 7,
                                                          2015 at 12:56
                                                          PM, Idel
                                                          Pivnitskiy <span dir="ltr">&lt;<a href="mailto:idel.pivnitskiy@gmail.com" target="_blank">idel.pivnitskiy@gmail.com</a>&gt;</span>
                                                          wrote:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">Yes,
                                                          Swagger can
                                                          generate doc
                                                          on the fly,
                                                          but Swagger
                                                          use its own
                                                          annotations
                                                          instead of
                                                          parse JAX-RS
                                                          annotations
                                                          and javadoc,
                                                          like MireDot.</div>
                                                          </blockquote>
                                                          <div><br>
                                                          </div>
                                                        </span>
                                                        <div>Ok, I think
                                                          I have not a
                                                          huge concern
                                                          against custom
                                                          annotations,
                                                          especially due
                                                          to the wide
                                                          adoption of
                                                          Swagger.</div>
                                                        <div>I guess
                                                          it&#39;s just a
                                                          very tiny JAR,
                                                          that contains
                                                          the
                                                          annotations,
                                                          right?</div>
                                                        <div><br>
                                                        </div>
                                                        <div>(+ the
                                                          build time
                                                          tool
                                                          dependency for
                                                          processing)</div>
                                                        <span>
                                                          <div> </div>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">
                                                          <div>What
                                                          about licence:
                                                          Apache Tika,
                                                          for example,
                                                          uses pro
                                                          version of
                                                          MireDot</div>
                                                          <div><br>
                                                          </div>
                                                          <div><a href="https://github.com/apache/tika/blob/5fbc56cca94b9da0a914e82dd466abb139f9e3f4/tika-server/pom.xml#L248-L266" target="_blank">https://github.com/apache/tika/blob/5fbc56cca94b9da0a914e82dd466abb139f9e3f4/tika-server/pom.xml#L248-L266</a></div>
                                                          </div>
                                                          </blockquote>
                                                          <div><br>
                                                          </div>
                                                        </span>
                                                        <div>Thanks for
                                                          the example,
                                                          that&#39;s helpful</div>
                                                        <div>
                                                          <div>
                                                          <div> </div>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">
                                                          <div>
                                                          <div>
                                                          <div><br>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote">2015-04-07
                                                          13:48
                                                          GMT+03:00
                                                          Matthias
                                                          Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">Swagger
                                                          allows doc on
                                                          the source as
                                                          well, right ?
                                                          Just
                                                          wondering.
                                                          <div><br>
                                                          </div>
                                                          <div>REgarding
                                                          license, I
                                                          need to double
                                                          check on that
                                                          before...</div>
                                                          </div>
                                                          <div>
                                                          <div>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote">On
                                                          Tue, Apr 7,
                                                          2015 at 11:57
                                                          AM, Idel
                                                          Pivnitskiy <span dir="ltr">&lt;<a href="mailto:idel.pivnitskiy@gmail.com" target="_blank">idel.pivnitskiy@gmail.com</a>&gt;</span>
                                                          wrote:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">
                                                          <div>Matthias,<br>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          Sure, I will
                                                          work on it.
                                                          <div>But I
                                                          think that it
                                                          would be
                                                          better if you
                                                          request a
                                                          license [1] on
                                                          your email and
                                                          forward it to
                                                          me.</div>
                                                          <div>It won&#39;t
                                                          be a problem
                                                          to use a free
                                                          version, but
                                                          pro version
                                                          has a very
                                                          cool features,
                                                          like:</div>
                                                          <div>
                                                          <ul>
                                                          <li>Display
                                                          javadoc
                                                          comments for
                                                          the fields of
                                                          json payloads
                                                          and enums<br>
                                                          </li>
                                                          <li>JSON field
                                                          documentation<br>
                                                          </li>
                                                          <li>Type
                                                          replacement
                                                          (custom
                                                          serialisation,
                                                          JSON types)<br>
                                                          </li>
                                                          </ul>
                                                          </div>
                                                          <div>Please,
                                                          request a li</div>
                                                          <div><br>
                                                          </div>
                                                          <div>[1] <a href="http://miredot.com/price/" target="_blank">http://miredot.com/price/</a></div>
                                                          </div>
                                                          <div>
                                                          <div>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote">2015-04-07
                                                          12:44
                                                          GMT+03:00
                                                          Matthias
                                                          Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr"><span style="font-size:12.8000001907349px">Idel,</span>
                                                          <div><span style="font-size:12.8000001907349px"><br>
                                                          </span></div>
                                                          <div><span style="font-size:12.8000001907349px">would
                                                          you mind to
                                                          create a
                                                          branch for us,
                                                          so we can
                                                          investigate
                                                          the MireDot
                                                          solution? also
                                                          the build
                                                          should be
                                                          working w/
                                                          JDK8.</span><br>
                                                          </div>
                                                          <div><span style="font-size:12.8000001907349px"><br>
                                                          </span></div>
                                                          <div><span style="font-size:12.8000001907349px">ATM
                                                          we use
                                                          jax-doclet
                                                          ([1]) which
                                                          does not work
                                                          w/ JDK 8 - but
                                                          it does not
                                                          really use any
                                                          fancy
                                                          annotations
                                                          (e.g. see [2])
                                                          - that&#39;s why
                                                          we picked it.</span></div>
                                                          <div><span style="font-size:12.8000001907349px"><br>
                                                          </span></div>
                                                          <div><span style="font-size:12.8000001907349px">Thanks!</span></div>
                                                          <div><span style="font-size:12.8000001907349px">Matthias</span></div>
                                                          <div><span style="font-size:12.8000001907349px"><br>
                                                          </span></div>
                                                          <div><span style="font-size:12.8000001907349px">[1] <a href="http://fromage.github.io/jax-doclets/docs/0.10.0/html/" target="_blank">http://fromage.github.io/jax-doclets/docs/0.10.0/html/</a></span></div>
                                                          <div><span style="font-size:12.8000001907349px">[2] <a href="https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102" target="_blank">https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102</a></span></div>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote"><span>On
                                                          Tue, Apr 7,
                                                          2015 at 9:54
                                                          AM, Lukáš Fryč
                                                          <span dir="ltr">&lt;<a href="mailto:lukas.fryc@gmail.com" target="_blank">lukas.fryc@gmail.com</a>&gt;</span>
                                                          wrote:<br>
                                                          </span>
                                                          <div>
                                                          <div>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">
                                                          <div>I agree
                                                          with Idel that
                                                          DRY approach
                                                          in Miredot&#39;s
                                                          case seems
                                                          more
                                                          appealing.<br>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          <div>They
                                                          offer basic
                                                          docs
                                                          generation in
                                                          Free version,
                                                          but also Pro
                                                          version for
                                                          open-source
                                                          projects under
                                                          conditions
                                                          that Aerogear
                                                          meets [1].</div>
                                                          <div><br>
                                                          </div>
                                                          <div>~ Lukas</div>
                                                          <div><br>
                                                          </div>
                                                          <div>[1] <a href="http://www.miredot.com/price/" target="_blank">http://www.miredot.com/price/</a><br>
                                                          <br>
                                                          <div class="gmail_quote">ne
                                                          5. 4. 2015 v
                                                          20:00
                                                          odesílatel
                                                          Idel
                                                          Pivnitskiy
                                                          &lt;<a href="mailto:idel.pivnitskiy@gmail.com" target="_blank">idel.pivnitskiy@gmail.com</a>&gt;
                                                          napsal:</div>
                                                          <div>
                                                          <div>
                                                          <div class="gmail_quote"><br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr">For
                                                          JAX-RS I
                                                          prefer use
                                                          MireDot as a
                                                          REST API doc
                                                          generator
                                                          <div><a href="http://www.miredot.com/" target="_blank">http://www.miredot.com/</a><br>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          <div>With
                                                          MireDot you do
                                                          not need to
                                                          use additional
                                                          annotations,
                                                          like @Api:</div>
                                                          <div>
                                                          <pre style="overflow:auto;font-family:Consolas,&#39;Liberation Mono&#39;,Menlo,Courier,monospace;font-size:13.6000003814697px;margin-top:0px;margin-bottom:0px;font-stretch:normal;line-height:1.45;padding:16px;border-radius:3px;word-wrap:normal;word-break:normal;color:rgb(51,51,51);background-color:rgb(247,247,247)">@Path(<span style="color:rgb(24,54,145)"><span>&quot;</span>/pet<span>&quot;</span></span>)
@Api(value <span style="color:rgb(167,29,93)">=</span> <span style="color:rgb(24,54,145)"><span>&quot;</span>/pet<span>&quot;</span></span>, description <span style="color:rgb(167,29,93)">=</span> <span style="color:rgb(24,54,145)"><span>&quot;</span>Operations about pets<span>&quot;</span></span>)</pre>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          <div>It will
                                                          parse your
                                                          JAX-RS
                                                          annotation and
                                                          pure javadoc:</div>
                                                          <div>
                                                          <pre style="overflow:auto;font-family:Consolas,&#39;Liberation Mono&#39;,Menlo,Courier,monospace;font-size:13.6000003814697px;margin-top:0px;margin-bottom:0px;font-stretch:normal;line-height:1.45;padding:16px;border-radius:3px;word-wrap:normal;word-break:normal;color:rgb(51,51,51);background-color:rgb(247,247,247)">/**
* Operations about pets
*/
@Path(<span style="color:rgb(24,54,145)"><span>&quot;</span>/pet<span>&quot;</span></span>)</pre>
                                                          </div>
                                                          <div>and
                                                          generate
                                                          beautiful and
                                                          user friendly
                                                          documentation,
                                                          like this: <a href="http://www.miredot.com/exampledocs/" target="_blank">http://www.miredot.com/exampledocs/</a></div>
                                                          <div>Swagger
                                                          example: <a href="http://petstore.swagger.io/" target="_blank">http://petstore.swagger.io/</a></div>
                                                          <div><br>
                                                          </div>
                                                          <div>And
                                                          MireDot is
                                                          free for open
                                                          source
                                                          projects!</div>
                                                          <div><br>
                                                          </div>
                                                          <div>Think
                                                          about this
                                                          alternative
                                                          for Swagger.
                                                          I&#39;m able to
                                                          prepare Pull
                                                          Request for
                                                          UPS next week.</div>
                                                          <div><br>
                                                          </div>
                                                          </div>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote">2015-04-04
                                                          9:43 GMT+03:00
                                                          Matthias
                                                          Wessendorf <span dir="ltr">&lt;<a href="mailto:matzew@apache.org" target="_blank">matzew@apache.org</a>&gt;</span>:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
                                                          <div dir="ltr"><br>
                                                          <div class="gmail_extra"><br>
                                                          <div class="gmail_quote"><span>On
                                                          Fri, Apr 3,
                                                          2015 at 10:27
                                                          PM, Heiko
                                                          W.Rupp <span dir="ltr">&lt;<a href="mailto:hrupp@redhat.com" target="_blank">hrupp@redhat.com</a>&gt;</span>
                                                          wrote:<br>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span>On
                                                          3 Apr 2015, at
                                                          18:53, Andrea
                                                          Vibelli wrote:<br>
                                                          <br>
                                                          &gt; we are
                                                          using it in
                                                          Project
                                                          Newcastle with
                                                          annotations on
                                                          the<br>
                                                          &gt;
                                                          endpoints, and<br>
                                                          &gt; it&#39;s
                                                          really handy.<br>
                                                          <br>
                                                          </span>All the
                                                          JBoss ON 3.2+
                                                          and RHQ
                                                          REST-docs are
                                                          generated from
                                                          JAX-RS +<br>
                                                          Swagger
                                                          annotations.<br>
                                                          In Hawkular we
                                                          are basically
                                                          doing the
                                                          same, but with
                                                          a different<br>
                                                          annotation
                                                          processor.<br>
                                                          </blockquote>
                                                          <div><br>
                                                          </div>
                                                          </span>
                                                          <div>+1000</div>
                                                          <div><br>
                                                          </div>
                                                          <div>we are,
                                                          atm, doing
                                                          similar:</div>
                                                          <div>source</div>
                                                          <div><a href="https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102" target="_blank">https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102</a><br>
                                                          </div>
                                                          <div>result:</div>
                                                          <div><a href="https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/sender/index.html#POST" target="_blank">https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/sender/index.html#POST</a><br>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          <div>but the
                                                          jaxrs doclet
                                                          does not work
                                                          w/ JDK8 -
                                                          something has
                                                          to change here
                                                          ;-)<br>
                                                          </div>
                                                          <div>So, I am
                                                          all for using
                                                          Swagger
                                                          annotations on
                                                          the code to
                                                          generate the
                                                          HTML docs :-)<br>
                                                          </div>
                                                          <div><br>
                                                          </div>
                                                          <div>Greetings,</div>
                                                          <div>Matthias</div>
                                                          <span>
                                                          <div> </div>
                                                          <blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><br>
                                                          I personally
                                                          think the best
                                                          is really to
                                                          have the
                                                          annotations in
                                                          the<br>
                                                          source and not
                                                          trying<br>
                                                          to update a
                                                          separate .yml
                                                          file, as the
                                                          latter usually
                                                          is much easier<br>
                                                          forgotten.<br>
                                                          <div>
                                                          <div>_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </div>
                                                          </div>
                                                          </blockquote>
                                                          </span></div>
                                                          <span><font color="#888888"><br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          -- <br>
                                                          <div>Matthias
                                                          Wessendorf <br>
                                                          <br>
                                                          blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
                                                          sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
                                                          twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
                                                          </font></span></div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                          <br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          </div>
                                                          <div class="gmail_extra">--
                                                          <br>
                                                          <div>
                                                          <div dir="ltr">
                                                          <div>
                                                          <div dir="ltr">Best
                                                          regards,
                                                          <div>Idel
                                                          Pivnitskiy<br>
                                                          <div>E-mail: <a href="mailto:Idel.Pivnitskiy@gmail.com" target="_blank">Idel.Pivnitskiy@gmail.com</a></div>
                                                          </div>
                                                          <div>Twitter:
                                                          <a href="https://twitter.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                                                          <div>GitHub: <a href="https://github.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a></blockquote>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <div>
                                                          <div><br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          -- <br>
                                                          <div>Matthias
                                                          Wessendorf <br>
                                                          <br>
                                                          blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
                                                          sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
                                                          twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                          <br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          -- <br>
                                                          <div>
                                                          <div dir="ltr">
                                                          <div>
                                                          <div dir="ltr">Best
                                                          regards,
                                                          <div>Idel
                                                          Pivnitskiy<br>
                                                          <div>E-mail: <a href="mailto:Idel.Pivnitskiy@gmail.com" target="_blank">Idel.Pivnitskiy@gmail.com</a></div>
                                                          </div>
                                                          <div>Twitter:
                                                          <a href="https://twitter.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                                                          <div>GitHub: <a href="https://github.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                          <br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          -- <br>
                                                          <div>Matthias
                                                          Wessendorf <br>
                                                          <br>
                                                          blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
                                                          sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
                                                          twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                          <br>
                                                          <div>
                                                          <div dir="ltr">
                                                          <div dir="ltr"><br>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          </div>
                                                          <br>
_______________________________________________<br>
                                                          aerogear-dev
                                                          mailing list<br>
                                                          <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                          <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                          </blockquote>
                                                          </div>
                                                        </div>
                                                      </div>
                                                      <div>
                                                        <div><br>
                                                          <br clear="all">
                                                          <div><br>
                                                          </div>
                                                          -- <br>
                                                          <div>Matthias
                                                          Wessendorf <br>
                                                          <br>
                                                          blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
                                                          sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
                                                          twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
                                                        </div>
                                                      </div>
                                                    </div>
                                                  </div>
                                                  <br>
_______________________________________________<br>
                                                  aerogear-dev mailing
                                                  list<br>
                                                  <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                                  <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                                </blockquote>
                                              </div>
                                              <br>
                                              <div>
                                                <div dir="ltr">
                                                  <div dir="ltr"><br>
                                                  </div>
                                                </div>
                                              </div>
                                            </div>
                                          </div>
                                        </div>
                                      </div>
                                    </div>
                                    <br>
_______________________________________________<br>
                                    aerogear-dev mailing list<br>
                                    <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                                    <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                                  </blockquote>
                                </div>
                              </div>
                            </div>
                            <div>
                              <div><br>
                                <br clear="all">
                                <div><br>
                                </div>
                                -- <br>
                                <div>Matthias Wessendorf <br>
                                  <br>
                                  blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
                                  sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
                                  twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
                              </div>
                            </div>
                          </div>
                        </div>
                        <br>
                        _______________________________________________<br>
                        aerogear-dev mailing list<br>
                        <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
                        <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
                      </blockquote>
                    </div>
                    <br>
                    <br clear="all">
                    <div><br>
                    </div>
                    -- <br>
                    <div>
                      <div dir="ltr">
                        <div>
                          <div dir="ltr">Best regards,
                            <div>Idel Pivnitskiy<br>
                              <div>E-mail: <a href="mailto:Idel.Pivnitskiy@gmail.com" target="_blank">Idel.Pivnitskiy@gmail.com</a></div>
                            </div>
                            <div>Twitter: <a href="https://twitter.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                            <div>GitHub: <a href="https://github.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div>
                          </div>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>
              </div>
              <br>
              _______________________________________________<br>
              aerogear-dev mailing list<br>
              <a href="mailto:aerogear-dev@lists.jboss.org" target="_blank">aerogear-dev@lists.jboss.org</a><br>
              <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
            </blockquote>
          </div>
          <br>
          <br clear="all"><span class=""><font color="#888888">
          <div><br>
          </div>
          -- <br>
          <div>Matthias Wessendorf <br>
            <br>
            blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>
            sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>
            twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
        </font></span></div><span class=""><font color="#888888">
      </font></span></div><span class=""><font color="#888888">
    </font></span></blockquote><span class=""><font color="#888888">
    <br>
  </font></span></div></div></div><span class=""><font color="#888888">

</font></span></div><span class=""><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div>Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
</font></span></div></div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr">Best regards,<div>Idel Pivnitskiy<br><div>E-mail: <a href="mailto:Idel.Pivnitskiy@gmail.com" target="_blank">Idel.Pivnitskiy@gmail.com</a></div></div><div>Twitter: <a href="https://twitter.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div><div>GitHub: <a href="https://github.com/idelpivnitskiy" target="_blank">@idelpivnitskiy</a></div></div></div></div></div>
</div></div>