Sandcastle имеет довольно сложный XML MAML для генерации концептуальной справки , как обсуждалось в хорошем вступлении 2007 . Как это соотносится с Doxygen с точки зрения простоты написания контента и контроля над генерацией страниц?
Я большой поклонник использования средства Doxygen page для написания такой концептуальной помощи, включая обсуждение вопросов дизайна. Он гораздо менее структурирован - есть главная страница , и вы можете выбрать способ группировки страниц, добавив ссылки с помощью команд subpage или ref .
Мне также нравится тот факт, что я могу включать случайные диаграммы Graphviz в свои страницы Doxygen или со встроенными фрагментами или со ссылкой на внешний файл.