Здравствуйте, Аноним, Вы писали:
...
Live Documenter, здесь

Хочу малое — генерацию документации по xml комментариям. Последний раз этим занимался очень давно, и тогда благополучно использовал NDoc. Проект, умер. Сейчас уже на .net 4 пишу. Стал искать по интернету, как это делают сейчас. Нашел проект Sandcastle (а так же расширения ввиде Styles и SHFB). Понял, что по сравнению с NDoc — Sandcastle просто монстр. Тьма шагов, все на утилиточном уровне. И полнейшее отсутствие ГУИ.

Стал искать дальше с надеждой, неужели за столько лет никто не доделал Sandcastle до production уровня. Нашел DocProject. И поддержка ГУИ. И интеграция в IDE. Правильный подход. Стал к нему присматриваться, а он оказывается предлагает MAML ручками писать. Ладно, нет редактора, будем ручками. Но и это не все. Этот проект так же благополучно умер.

Скажите, есть ли среди форумчан те, что создают документацию? Нужна онлайн + оффлайн. Чем пользуетесь?

Здравствуйте, Аноним, Вы писали:

А>Скажите, есть ли среди форумчан те, что создают документацию? Нужна онлайн + оффлайн. Чем пользуетесь?

Sandcastle + SHFB. Да, мерзко, да, противно.
Зато формат проекта документации — MsBuild, легко встраивается в автоматическую сборку. (Ну как легко... Не без приседаний, конечно.)

Здравствуйте, Аноним, Вы писали:


А>Стал искать дальше с надеждой, неужели за столько лет никто не доделал Sandcastle до production уровня. Нашел DocProject. И поддержка ГУИ. И интеграция в IDE. Правильный подход. Стал к нему присматриваться, а он оказывается предлагает MAML ручками писать. Ладно, нет редактора, будем ручками. Но и это не все. Этот проект так же благополучно умер.

А>Скажите, есть ли среди форумчан те, что создают документацию? Нужна онлайн + оффлайн. Чем пользуетесь?
Пока ничем, припрёт — http://submain.com/GhostDoc/

Есть ещё полуживые
http://www.inchl.nl/SandcastleGUI/
и
http://sourceforge.net/projects/ndoc3/

Здравствуйте, Qbit86, Вы писали:

Q>Здравствуйте, Аноним, Вы писали:

А>>Скажите, есть ли среди форумчан те, что создают документацию? Нужна онлайн + оффлайн. Чем пользуетесь?

Q>Sandcastle + SHFB. Да, мерзко, да, противно.
Q>Зато формат проекта документации — MsBuild, легко встраивается в автоматическую сборку. (Ну как легко... Не без приседаний, конечно.)

Для меня все же главное простота работы. А документацию я планирую собирать не чаще, чем раз в месяц. Автоматика вряд ли что-то сильно упростит.

Я сильно удивлен. Не думал, что на этом поприще не будет ни одного достойного решения. А чем MS генерирует свой MSDN?

Здравствуйте, Аноним, Вы писали:
...
И тут в тред врывается NDoc3, как реинкарнация оригинального NDoc:
http://sourceforge.net/projects/ndoc3/

Мы кстати, успешно и легко перешли на него. Правда немного правил сорцы.
API нашего продукта: 1.5mb xml'ов.
Не знаю как сейчас, но Sandcastle на таких объемах считал часами.