@asdz

Какие есть средства организации онлайн документирования и просмотра исходного кода (C#)?

Хотелось бы иметь локальный сервер документирования и одновременно просмотра исходного кода наподобие referencesource.microsoft.com/. Чтобы можно было загрузить исходники и по комментариям была сгенерирована документация, где нужно к методам, классам дописать свою документацию. Все это можно было смотреть онлайн через браузер и при необходимости выгрузить в виде документа или файла стравки.
  • Вопрос задан
  • 682 просмотра
Решения вопроса 3
eduardtibet
@eduardtibet
Technical Writer / Documentation Engineer
Doxygen?

Первый вариант: по связке: SCM - выгрузка на диск - генерация - web-server. Правда, здесь онлайн документирования не будет - только документирование в коде.

Второй вариант: SCM - выгрузка в docbook - комментарии в XML Editor applet (прямо на сервере) - генерация - web-server. Но опять же с онлайном в чистом виде (как в wiki) не будет - только через выполнение апплета на клиентской машине.

Да, и еще... забыл добавить. Тот ресурс, который вы привели, использует статику. В нем нет возможности обновить онлайн.
Ответ написан
@damir2497
Software Engineer
Если хотите прямо как referencesource.microsoft.com, source.roslyn.io, то используйте https://github.com/KirillOsenkov/SourceBrowser с использованием которых они и сделаны.
Если хотите постоянно обновлять - добавьте таску в Continuous integration - генерацию и паблиш.
Ответ написан
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Войти через центр авторизации
Похожие вопросы