use namespace in @param

Является ли хорошей практикой включение пространств имен классов в аннотации @param? Я знаю, что phpdoc не поддерживает пространства имен, но как будут действовать другие инструменты, такие как phpdox или Doxygen?

Какой способ лучше / более распространен?

namespace foo\someNamespace;
use foo\someOtherNamespace\MyOtherClass;

--- with namespace ---

/**
 * @param \foo\someOtherNamespace\MyOtherClass $otherClass
 */
class myClass(MyOtherClass $otherClass)
{
    // do something
}

--- without namespace ---

/**
 * @param MyOtherClass $otherClass
 */
class myClass(MyOtherClass $otherClass)
{
    // do something
}
8
задан Sebastian Heuer 9 December 2011 в 16:07
поделиться