При создании документации с помощью phpDocumentor, если @param, значение @return является классом в вашем проекте, например:
@return My\Awesome\Class
phpdoc автоматически свяжет My \ Awesome \ Class с документацией для этого класса. Я пытаюсь выяснить, есть ли способ связать его с документацией для класса вендора, то есть make:
@return \Doctrine\Collection\Collections\ArrayCollection
ссылка на http://www.doctrine-project.org/api/common/2.5/class-Doctrine.Common.Collections.ArrayCollection.html. Самое близкое решение, которое я смог выяснить, — это сгенерировать phpdoc документацию также для всех библиотек вендоров, что кажется далеко не идеальным.
Задача ещё не решена.
Других решений пока нет …