Грозный не работает с облачными функциями , по той же причине, по которой не работает. Вместо этого пользуйтесь автобусом. Как выполнить загрузку файла HTTP с помощью Express on Cloud Functions для Firebase (multer, busboy) Так что этот вопрос так или иначе связан с вышеуказанными проблемами в ссылках, если кто-то не возражает, как сейчас ...
Для генерации области, где можно определить описание для функции и каждый параметр для функции введите следование строки перед функцией и совершите нападки Входят :
C#: ///
VB: '''
Видят Рекомендуемые Теги для Комментариев для документации (Руководство по программированию C#) для большего количества информации о структурированном содержании, которое можно включать в эти комментарии.
Также дополнительный фантомный документ Visual Studio попытается создать и временная замена комментарии заголовка с Вашего имени функции.
Сделайте комментарий XML, как это
/// <summary>
/// This does something that is awesome
/// </summary>
public void doesSomethingAwesome() {}
используйте///для начала, каждая строка комментария и иметь комментарий содержат соответствующий xml для читателя метаданных.
///<summary>
/// this method says hello
///</summary>
public void SayHello();
, Хотя лично, я полагаю, что эти комментарии обычно дезинформируются, если Вы не разрабатываете классы, где код не может быть прочитан его потребителями.
Solmead имеет корректный ответ. Для большего количества информации можно посмотреть XML-комментарии .
Их называют XML-комментарии . Они были частью Visual Studio с тех пор навсегда.
можно сделать процесс документации легче при помощи GhostDoc, свободное дополнение для Visual Studio, которая генерирует комментарии XML-документа для Вас. Просто поместите свое каре в метод/свойство, Вы хотите зарегистрировать, и нажать Ctrl-Shift-D.
Вот пример от одно из моих сообщений .
Hope, которая помогает:)
То, в чем Вы нуждаетесь, комментарии xml - в основном, они следуют за этим синтаксисом (как неопределенно описано Solmead):
C#
///<summary>
///This is a description of my function.
///</summary>
string myFunction() {
return "blah";
}
VB
'''<summary>
'''This is a description of my function.
'''</summary>
Function myFunction() As String
Return "blah"
End Function