docblocks

0зной

1ответ

JSDoc: объединение (факультативно) @param и @type для геттера/инкубационных функциональных свойств

- Как можно использовать @param намек на дополнительных параметров для function, что является свойством (this.selectedPage()) , а также использование@type намекнуть на его тип возврата? Возьмите это,

javascript documentation jsdoc docblocks 2016-02-01

---

5зной

3ответ

Дописывают ли типы деклараций и аннотации типов устаревшие или дополняют друг друга?

Я всегда использовал аннотации для объявления типа возврата. Например: /** * @return SomeClass */ public function() { ... } Но теперь я вижу, что есть еще один способ: public function() : SomeCla

php php-7 return-type docblocks type-declaration 2016-12-01

---

1зной

1ответ

Удалить [] квадратные скобки от DocBlockr comment

Мне нравится плагин DocBlockr для возвышенного текста, но я хотел бы, чтобы мои комментарии были немного разными. Нормальное Внешность: И как бы мне хотелось, чтобы они появились: Так type, descriptio

sublimetext sublime-text-plugin docblocks 2015-08-07

---

0зной

1ответ

Есть ли соглашение в PHP, чтобы отметить, где функция выполняется в тестах?

У нас уже есть reverse convention, где в тестовом док-блоке phpUnit нормально использовать аннотацию @covers. Если вы смотрите на кусочек кода, часто полезно посмотреть на тесты, которые выполняют эту

php conventions docblocks 2016-07-22

---

0зной

1ответ

ReflectionMethod-> getDocComment(), похоже, не работает на PHP 5.5

Я пытаюсь создать интерфейс из методов reflectionMethods для одного из моих классов, и у меня есть проблема, когда метод getDocComments() не работает на моем промежуточная среда. Вот тестовый код я ис

php reflection docblocks 2017-02-07

---

1зной

2ответ

ли PHP есть соглашение для описания Promise возвращается в функции DocBlock

Я просто написал функцию как этого /** * Send an asynchronous GET request * * @param string $url * @param array $options * * @return \React\Promise\ExtendedPromiseInterfa

php documentation promise docblocks 2016-06-20

---

0зной

2ответ

Использование DocBlocks на PHP, Должен ли я использовать @throws, когда я не обрабатываю ошибки с execpetion?

У меня есть класс для обработки ошибок, и он не использует механизм try-throw-catch. Когда я комментирую код, который использует этот класс, должен ли использовать тег @throws, даже если я вообще ниче

php comments docblocks 2015-10-22

---

1зной

1ответ

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

Скажем, у меня есть одна линия summary, должен ли я право это так: /** summary */ или я могу написать это: /** * summary */ Я предпочитаю второй вариант, но в том, что требуется использовать пер

php docblocks 2015-10-22

---