Есть ли стандартный способ, которым инструменты, используемые для создания документов API, обрабатывают комментарии стиля XML к частичным классам? В принципе, как следует прокомментировать частичный класс / метод, чтобы полученные справочные документы не были искажены? Этот вопрос может варьироваться в зависимости от используемого инструмента, и в этом случае я полагаю, что двумя наиболее важными инструментами являются:
Я не хочу, чтобы моя XML-документация выглядела напуганной, это все
/// <summary>Some Foo class</summary>
public partial class Foo { ... }
/// <summary>Some Foo class that implements some interface.</summary>
public partial class Foo : ISomeInterface { ... }