Нужна ссылка на правила документирования php файлов

[fixxxer]

Если можно откуда-то вывести тип (скажем, есть присваивание в конструкторе), то он обычно выводит. Понятно, что мысли сторм пока читать не умеет.

 

[fixxxer]

Про нетбинс, именно по этому мне нужно научиться правильно коммментировать)

Да не поможет нифига.
Вот простейший пример (не то, что так надо делать, но иллюстрирует проблему):

class Base {
    /**
     * @return $this
     * // или return static - неважно
     */
    public static function construct() {
        return new static();
    }
    /**
     * @return $this
     */
    public function foo() {
        return $this;
    }
}

class Bar extends Base {
     public function baz() {}
}

Bar::construct()
    ->foo()
    ->baz(); // ой!

Сторм на таком тоже лажал, но давно починили.

 

[WMix]

так ты напиши тип аргумента в сигнатуре. И если уже об этом @var ключевое слово, тип следуещее