Мы используем sandcastle (и SHFB) для создания документации по библиотеке классов из встроенных комментариев XML. Это отличный инструмент для поддержки полной и профессиональной справки + обзорной документации, включая правильные образцы кода.
К сожалению, это тоже собака медленная. Это, безусловно, самый трудоемкий шаг в нашей автоматизированной сборке, и это начинает болеть. Есть ли способ ускорить его?
Если у вас есть SdkLinkType = Msdn (см. свойства вашего проекта SHFB), sandcastle подключается к документации MSDN с помощью веб-службы. Это может привести к сбою в случае проблем с подключением. Вы можете попытаться установить SdkLinkType = None, чтобы отключить построение ссылок MSDN (в этом случае у вас не будет ссылок на MSDN в вашей помощи). В моем случае это улучшило мое время сборки 5 раз (2 минуты вместо 10 минут).
Дискуссионная группа в CodePlex довольно активна и известна. Здесь полу в теме сообщение (нет помощи хотя): http://sandcastle.codeplex.com/Thread/View.aspx?ThreadId=32267