Всем привет! Совсем недавно у меня возникла задача задокументировать весь код в проекте, чтобы при использовании метода, интеллисенс студии подсказывал о нём всё, что только можно. Единственное, что я смог найти для своей ситуации - это XML документация, для .csproj. Но, насколько я понял это получается не слишком красиво и очень громоздко в исходниках. Тем более, если делать через xml:lang="LANG_ID". Какой подход наиболее хороший и правильный, для документирования кода? В конечном итоге, конечно, хотелось бы достичь такого результата, как у дотнета из коробки.
UPDATE #1
Сейчас мне пришла в голову очень странная идея, для моей задачи, мне нужна просто документация для какой-то DLL на разных языках и всё. Думаю написать какую-нибудь тулзню, которая будет подниматься на prebuild эвенте и выставлять везде где нужно документацию, чтобы студия сбилдила XML файл. А на postbuild эвенте будет подниматься тулзня, которая будет очищать все выставленные строчки. Этот подход позволить сделать код чистым от доки и полностью автоматизировать процесс (только саму доку придется править).
Не хочу расстроить, но XML-комментарии, это то единственное, что позволит вам достичь желаемого результата. А для того чтобы процесс их написания не был таким "болезненным" и скучным, от себя могу порекомендовать расширение для Visual Studio под названием GhostDoc, которое позволяет автоматизировать и стандартизировать некоторые рутинные действия и операции.
Апостиль в Лос-Анджелесе без лишних нервов и бумажной волокиты
Основные этапы разработки сайта для стоматологической клиники
Продвижение своими сайтами как стратегия роста и независимости