Уже который раз встречаю попытки использовать SandCastle для создания документации к коду. Видел на CodeProject несколько статей, видел даже специальный SandCastleBuilder...
Вот и сегодня наткнулся на заметку.
Я тоже пробовал запускать, переделывать бат-файл, использовать GUI, сделанный непонятно кем, но ленивым, чтобы батник не запускать :)
Однако, пока еще очень сыро.
В качестве хорошей альтернативы можно пользоваться NDoc. Версию, поддерживающую .NET 2.0 со всякими там Generics и т.д. можно найти тут: http://jonas.lagerblad.com/blog/?p=4
GUI там тоже прилагается.
В общем, у меня работает прекрасно - сгенеренной документацией дивелоперы, использующие мой API довольны.
Возможности расширения тоже есть, только ни разу не приходилось пользоваться :)