title: AngularJS comments style guide
body: <p>When looking at the source code of Angular it seems there is a certain way how to style the comments. A quick <a href="https://www.google.no/webhp?sourceid=chrome-instant&amp;ion=1&amp;espv=2&amp;ie=UTF-8#q=angular%20comments%20style%20guide" rel="nofollow">google search</a> does not reveal what rules to follow. What are the guidelines?</p>
  
  <p>For example, a comment for a function looks like this:</p>
  
  <pre><code>/**
  * when using forEach the params are value, key, but it is often useful to have key, value.
  * @param {function(string, *)} iteratorFn
  * @returns {function(*, string)}
  */
  function reverseParams(iteratorFn) {
    return function(value, key) { iteratorFn(key, value); };
  }
  </code></pre>
  
  <p>It starts with a slash (/) and followed by two two asterisks (*) and it has an asterik on every line. Where is that defined? And then there are several @-symbols. Javascript comments starts with <code>/*</code> or <code>//</code>, as <a href="http://www.w3schools.com/js/js_comments.asp" rel="nofollow">described here</a>, so there are some additional styling involved here. I am searching for a description on this....</p>