title: What is the preferred method of commenting JavaScript objects and methods?
body: <p>I'm used to Atlas where the preferred (from what I know) method is to use XML comments such as:</p>
  <pre><code>/// &lt;summary&gt;
  ///   Method to calculate distance between two points
  /// &lt;/summary&gt;
  ///
  /// &lt;param name=&quot;pointA&quot;&gt;First point&lt;/param&gt;
  /// &lt;param name=&quot;pointB&quot;&gt;Second point&lt;/param&gt;
  ///
  function calculatePointDistance(pointA, pointB) { ... }
  </code></pre>
  <p>Recently I've been looking into other third-party JavaScript libraries and I see syntax like:</p>
  <pre><code>/*
   * some comment here
   * another comment here
   * ...
   */
   function blahblah() { ... }
  </code></pre>
  <p>As a bonus, are there API generators for JavaScript that could read the 'preferred' commenting style?</p>