В DocBlocks я должен всегда использовать однострочное обозначение при написании одной строки?

Question

Допустим, у меня есть одна строка summaryДолжен ли я исправить это так:

/** summary */

или я могу написать это так:

/**
 * summary
 */

Я предпочитаю второй вариант, но нужно ли использовать первый вариант?

Answer 1

Согласно документации, "DocComments может иметь размер одной строки, но также может занимать несколько строк" ​​(выделено мной.)

Таким образом, вы можете сделать это в любом случае.