Удобный и полезный инструмент NDoc, которым многие пользовались для генерации документации к своему коду, видимо окончательно прекратил свое развитие. Последний релиз датирован началом прошлого, 2005-го года, а это значит, что ожидать от него полноценной поддержки .NET 2.0 не приходится.
Совершенно неожиданно на помощь приходит Microsoft и выпускает в публику Sandcastle - инструмент, который сам использует для генерации документации к .NET Framework. Похоже, со внутренними инструментами в МС такая же ситуация, как и везде. Прежде чем опубликовать, надо серьезно причесать. Так что пока выпущено только превью.
К сожалению, пользоваться этой штукой пока сложно - нужно запустить правильную последовательность утилит через командную строку, в процесс правильным образом копируя файлы туда-сюда. Разработчики в своем блоге опубликовали уже две инструкции (1 и 2). Добрые люди написали вспомогательные скрипты:
Наконец, существует плагин для студии - Visual Studio 2005 Add-In Suite with Sandcastle. Кажется, он должен быть наиболее подходящей кандидатурой для использования. Впрочем, я сам пока еще ничего этого не пробовал.
Основные ссылки:
P.S. Этот пост написан при помощи Windows Live Writer. Вроде, ничего штука.
tags: .NET, Sandcastle.
Posted
Aug 16 2006, 07:51 PM
by
Andrew Mayorov