Я использую Sandcastle в течение 2 лет для создания документации для библиотеки с открытым исходным кодом. Но теперь я ищу альтернативу, потому что:
- Даже при использовании Sandbule Help File Builder, Sandcastle слишком сложна для моего вкуса. Создание документации должно быть таким же простым, как щелчок кнопки или меню в Visual Studio.
- Проект, похоже, больше не поддерживается; последняя версия была выпущена в июне 2010 года, и, похоже, кто-то еще не работает над ней. Ошибки больше не исправлены, что для меня большая проблема (моя библиотека сильно использует методы расширения, а эта ошибка испортила все)
- Поскольку это будет проект с открытым исходным кодом, коммерческие продукты, такие как VSdocman и Document! X для меня не может быть и речи.
Уже есть несколько похожих questions на SO, но они все довольно старые, и предложенные альтернативы не соответствуют моим потребностям. NDoc был довольно хорош, но он больше не поддерживается и не поддерживает последние функции (методы расширения, прикрепленные свойства...). Мне не нравится стиль документации, созданной Docu и Doxygen, я ищу инструмент, который создает документацию в стиле MSDN.
Итак, есть ли другой инструмент, который я мог бы использовать? Или я застрял с Sandcastle?