правильный phpdoc @return для заводского метода

Question

Мне интересно, как документировать следующий сценарий. Представьте себе группу классов:

abstract class Personality {}
class Me extends Personality {}
class Myself extends Personality {}
class Irene extends Personality {}

Если я пишу фабричный метод для создания экземпляра и возврата подкласса класса Personality, как мне правильно задокументировать @return?

@return mixed  A "Personality" subclass object

или

@return Personality  A "Personality" subclass object

Answer 1

@return Personality A "Personality" subclass object

самый лучший. А IDE предоставит вам свойства автозаполнения для класса Personality.