title: Java - Convention for using javadoc along with a method annotation?
body: <p>I have the following method:</p>
  
  <pre><code>   @Override
     public boolean myMethod()
     {
        // do stuff
     }
  </code></pre>
  
  <p>If I want to add a javadoc for this method, is there any convention on how to do this along with having the @Override annotation (or any other annotation)?</p>
  
  <p>The reason I ask is because I've read that javadoc comments MUST be directly before the method (no newlines between the two), and I'm not sure if putting the javadoc comment directly above the @Override annotation would mess things up.</p>
  
  <p>Would this be the conventional way to do it for instance? Does this work?</p>
  
  <pre><code>   /**
      * This is my method's javadoc comment.
      */
     @Override
     public boolean myMethod()
     {
        // do stuff
     }
  </code></pre>