Прежде всего, я видел Создание документации из комментариев C# XML и многие другим это нравится, но ни один из предложенных инструментов не работает для того, что мне нужно.
Мне нужен бесплатный инструмент, который может генерировать документацию (желательно в формате html) из моего исходного кода без использования документа xml, созданного Visual Studio. В проекте есть предупреждения о включенных ошибках, и проверка опции создания этого XML-файла приводит к сотням ошибок. По сути, это исключает 90% генераторов документации C#, включая Sandcastle, NDoc3, Live Documenter, docu и ImmDoc.
Doxygen почти работает, но я не могу заставить его генерировать документацию для перегруженных универсальных классов, таких как:
public class MyClass<Foo>
public class MyClass<Foo, Bar> : MyClass<Foo>
У MyClass есть документация, а у MyClass нет.
Тогда вопрос - есть ли:
- генератор документации, который я не видел, который может справиться с этим случаем,
- параметр конфигурации в одном из перечисленных мной инструментов, который заставит его работать, не требуя файла xml-документации,
- или даже способ отключить просто предупреждения компилятора комментариев, не влияя на предупреждения сборки?
Редактировать. Решение с помощью метода № 3 состоит в том, чтобы подавить следующие предупреждения, относящиеся к комментариям xml: 1570, 1571, 1572, 1573, 1574, 1580, 1581, 1584, 1587, 1589, 1590, 1591, 1592, 1598, 1710, 1711, 1712, 1723