Де-факто стандарт для документации на .NET использует XML комментарии внутри кода. Просто поместите курсор перед объявлением метода и введите ///. Visual Studio автоматически выведет аргументы и сгенерирует необходимый раздел, который вы можете заполнить. Затем просто включите документацию XML:
Если вы хотите сгенерировать документацию в стиле MSDN из полученного XML-файла, вот несколько инструментов, которые вы можете использовать: