Как создать документацию только в формате HTML из веб-проекта aspdotnet?

Вы можете посмотреть ndoc http://ndoc.sourceforge.net/

По сути, в свойствах вашего проекта вам нужно включить XML-документацию. Поэтому щелкните правой кнопкой мыши свой проект, выберите свойства, перейдите на вкладку «Сборка» и установите флажок «XMLDocumentation».

Это создает файл xml (не html). Затем вам нужно преобразовать (или проанализировать) XML-файл с помощью таблицы стилей XSLT. Вот где nDoc приходит.

Sandcastle (преемник ndoc) — отличный инструмент для документирования, но, по иронии судьбы, способ его простого и эффективного использования плохо документирован. Вам следует использовать построитель файлов справки Sandcastle (SHFB) или аналогичную платформу, а не пытаться получить доступ к Sandcastle напрямую. (Подумайте о солнце: его хорошо иметь рядом, но вы не хотите смотреть прямо на него без сильных солнцезащитных очков :-) Тогда возникает вопрос как использовать SHFB?

Моя статья за сентябрь 2010 г. Укрощение песочного замка: Руководство программиста .NET по документированию кода подробно описывает, что вам нужно сделать, и указывает на множество потенциальных ловушек, с которыми вы, вероятно, столкнетесь. В октябре 2010 г. я добавил к этому одностраничная настенная диаграмма, которая обобщает лексикон комментариев XML-документации для SHFB.

Из моего исследования для статьи, вот полный список других полезных ресурсов:

• Эрик Вудрафф документация по созданию файлов справки Sandcastle (создатель SHFB)
• Руководство по программированию на C#: рекомендуемые теги для комментариев к документации (MSDN)
• Вт. Руководство по комментариям к XML-документации Эрика Брансена (Dynicity)
• XML-документация на C# Энсона Хортона (руководитель программы компилятора Microsoft C#)