title: What is the new format of documentation comments in Swift 2? (XCode 7 beta 3)
body: <p>There is this <a href="http://nshipster.com/swift-documentation/" rel="noreferrer">great article</a> by Nate Cook and Mattt Thompson that describes the format of documentation comments in Swift.</p>
  
  <p>However, since Swift 2 in XCode 7 beta some parts of it do not seem to work any more.  For example <code>:param:</code> and <code>:returns:</code> do not produce desired result (they are simply rendered as-is instead).</p>
  
  <p>Other parts seem do keep working, though (i.e. both types of comments in <code>/// ...</code> or <code>/** ... */</code> style, code-blocks, lists), but no way to mark up the documentation into similar sections like the core API has.</p>
  
  <p>Does someone know if there is a way to highlight method parameters and returned results (what <code>:param:</code> and <code>:returns:</code> did in the past) in documentation comments in Swift 2?</p>