GetDocumentationCommentXml sometimes has no root element

[carlreinke]

ISymbol.GetDocumentationCommentXml(...) sometimes returns XML with a root element and sometimes without:

• DocumentationCommentCompiler (used by source symbols) returns XML with a root <member> element.
• VisualStudioDocumentationProvider (used by metadata symbols when running in VS host) returns XML with a root <doc> element (as documented here).
• XmlDocumentationProvider (used by metadata symbols when running in code analysis host) returns ReadInnerXml() of the <member> element. The inner XML has no root element.

Expected behavior: XML returned from ISymbol.GetDocumentationCommentXml(...), if not empty, has a root element (i.e., XmlDocumentationProvider returns the <member> element rather than its inner XML).

Actual behavior: XML returned from ISymbol.GetDocumentationCommentXml(...) sometimes has no root element.

[mavasani]

Compiler API issue, moving to the compiler team.