title: Tools and guide for documenting TypeScript code?
body: <p>Are there any tools for generating documentation for TypeScript source code? Or should I use something generic like NaturalDocs? What would be the recommended style of the block comments / those intended for standalone volume of documentation.</p>
  
  <p>Should I use:</p>
  
  <pre><code>///&lt;foo&gt;bar&lt;/foo&gt; MSVS kind of comments?
  </code></pre>
  
  <p>or</p>
  
  <pre><code>/** @javadoc style comments */
  </code></pre>
  
  <p>or perhaps</p>
  
  <pre><code>/*
    Something like this?
   */
  </code></pre>
  
  <p>I'm afraid to use <code>///</code> because it is used for imports, and I don't want to tread on some other future feature possibly introduced in the similar way - but you never know...</p>
  
  <p>Or is it possible to generate documented JavaScript from TypeScript and then use the JavaScript toolchain?</p>