title: Why Roslyn team marked DocumentationComment as internal
body: <p>We are trying to migrate from Roslyn's CTP to latest Roslyn release. But seems that they updated <code>DocumentationProvider</code> logic. In CTP it used <code>DocumentationComment</code> class that was returned by this provider. This class has useful logic for xml parsing for these properties</p>
  
  <pre><code>public string FullXmlFragmentOpt { get; private set; }
  
  public string ExampleTextOpt { get; private set; }
  
  public string SummaryTextOpt { get; private set; }
  
  public string ReturnsTextOpt { get; private set; }
  </code></pre>
  
  <p>In the new version of Roslyn <a href="http://source.roslyn.codeplex.com/#Microsoft.CodeAnalysis.Workspaces/Shared/Utilities/DocumentationComment.cs#612fe00e1a145e0d" rel="nofollow"><code>DocumentationComment</code></a> class was improved with new properties, but somehow it was marked as <code>internal</code>. And now <code>DocumentationProvider</code> returns just the full string with XML content. And as <code>DocumentationComment</code> is an internal class - we can't use it.</p>
  
  <p>Is there a reason why Roslyn team did it? Or maybe they are going to return it back in next release?</p>