title: In javaDoc, what's the best way of representing attributes in XML?
body: <p>When you're adding javaDoc comments to your code and you're outlining the structure of an XML document that you're passing back, what's the best way to represent attributes? Is there a best practice for this?</p>
  
  <p>My general structure for my javaDoc comments is like this:</p>
  
  <pre><code>/**
   * ...
   * 
   * @return XML document in the form:
   * 
   * &lt;pre&gt;
   * &amp;lt;ROOT_ELEMENT&amp;gt;
   *    &amp;lt;AN_ELEMENT&amp;gt;
   *    &amp;lt;MULTIPLE_ELEMENTS&amp;gt;*
   * &amp;lt;/ROOT_ELEMENT&amp;gt;
   * &lt;/pre&gt;
   */
  </code></pre>