title: Tags in javadoc comments for interface methods?
body: <p>I'm writing an interface in java, and I'm wondering if I should include tags in the interface's method's javadoc comments (@param, @return etc.) or if I should only include those tags in the implementing classes' method's javadoc comments. Here is an example:</p>
  
  <p>I have an interface ShapeInterface, and there are implementing classes for shapes (Circle, Triangle, etc.)</p>
  
  <p>So should javadoc comments appear like this?</p>
  
  <pre><code>public interface ShapeInterface{
  
  /**
   * Sets the x-coordinate for this shape
   * @param x the x-coordinate for this shape
   */
  public void setX(int x);
  
  /**
   * Gets the x-coordinate of this shape
   * @return this.x the x-coordinate of this shape
   */
  public int getX();
  }
  </code></pre>
  
  <p>Or should they appear like below, with the tags only appearing in the javadoc comments of the implementing class's methods?</p>
  
  <pre><code>public interface ShapeInterface{
  
  /**
   * Sets the x-coordinate for this shape
   */
  public void setX(int x);
  
  /**
   * Gets the x-coordinate of this shape
   *
  public int getX();
  }
  </code></pre>
  
  <p>Thanks</p>