在C#代码中询问文档注释的约定时,答案总是导致使用XML注释。微软建议使用此方法本身以及。 https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/recommended-tags-for-documentation-comments
/// <summary>
/// This is an XML comment.
/// </summary>
void Foo();
然而,检查微软的代码,如ASP.NET核心的时候,而不是评论是这样的。
//
// Summary:
// A builder for Microsoft.AspNetCore.Hosting.IWebHost.
public interface IWebHostBuilder
是否与本公约所包含的文档生成工具的工作,或者是有一个文档生成工具,采用了这种约定,而不是XML?为什么微软在他们的代码中使用这种约定,而不是XML注释的,他们推荐自己呢?