генерировать документацию по замку из песка для решения С#

У меня есть решение vs2012, в котором есть несколько проектов С#. Я хотел бы создать некоторую документацию, используя Sandcastle для всей библиотеки.

Я просматривал документацию Sandcastle и не понимаю, как я могу создать документацию для всего проекта.

Как я могу добиться этого для всего решения?


person amateur    schedule 16.11.2012    source источник
comment
Вы можете добавить целое решение в SandCastle. Разве вы не установили инструмент, который вы рассматриваете?   -  person Panos Rontogiannis    schedule 16.11.2012


Ответы (2)


Как указал ChrisW, вы должны использовать Sandcastle Help File Builder (SHFB). Тем не менее, даже с чистым и простым графическим интерфейсом, предоставляемым SHFB, существует довольно много вопросов, которые вам могут понадобиться или которые вы хотите рассмотреть, чтобы создать аккуратный, профессиональный набор документации. Моя статья ("Укрощение замка из песка: руководство для программиста .NET по документированию кода"), документирующий мой опыт работы с различными подводными камнями, опубликованный на Simple-Talk.com, может сэкономить вам время и усилия. , и агония :-).

После того, как вы ознакомились со статьей и, возможно, представляете больший интерес, я помещаю полное руководство по синтаксису и использованию SHFB и Sandcastle на этот одностраничная настенная диаграмма, доступная на Simple- Talk.com. Вот краткий обзор:

введите здесь описание изображения

person Michael Sorens    schedule 17.11.2012

Я использовал построитель файлов справки Sandcastle (вместо непосредственного использования Sandcastle).

В проекте SHFB вы можете указать несколько DLL + XML в разделе <DocumentationSources>.

person ChrisW    schedule 16.11.2012