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