Является ли хорошей практикой включение пространств имен классов в аннотации @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
}