Всем привет! Совсем недавно у меня возникла задача задокументировать весь код в проекте, чтобы при использовании метода, интеллисенс студии подсказывал о нём всё, что только можно. Единственное, что я смог найти для своей ситуации - это XML документация, для .csproj. Но, насколько я понял это получается не слишком красиво и очень громоздко в исходниках. Тем более, если делать через xml:lang="LANG_ID". Какой подход наиболее хороший и правильный, для документирования кода? В конечном итоге, конечно, хотелось бы достичь такого результата, как у дотнета из коробки.
UPDATE #1
Сейчас мне пришла в голову очень странная идея, для моей задачи, мне нужна просто документация для какой-то DLL на разных языках и всё. Думаю написать какую-нибудь тулзню, которая будет подниматься на prebuild эвенте и выставлять везде где нужно документацию, чтобы студия сбилдила XML файл. А на postbuild эвенте будет подниматься тулзня, которая будет очищать все выставленные строчки. Этот подход позволить сделать код чистым от доки и полностью автоматизировать процесс (только саму доку придется править).
Не хочу расстроить, но XML-комментарии
, это то единственное, что позволит вам достичь желаемого результата. А для того чтобы процесс их написания не был таким "болезненным" и скучным, от себя могу порекомендовать расширение для Visual Studio
под названием GhostDoc, которое позволяет автоматизировать и стандартизировать некоторые рутинные действия и операции.
Кофе для программистов: как напиток влияет на продуктивность кодеров?
Рекламные вывески: как привлечь внимание и увеличить продажи
Стратегії та тренди в SMM - Технології, що формують майбутнє сьогодні
Выделенный сервер, что это, для чего нужен и какие характеристики важны?
Современные решения для бизнеса: как облачные и виртуальные технологии меняют рынок
Можно ли как-нибудь вызвать по таймеру асинхронную функцию в C#? У обычного SystemThreading
Читал, что есть Monodroid и Monotouch - фреймворки от XamarinИнформации маловато, оф