> а здесь я вижу лишь метод и мне приходится копаться в коде, чтобы понять для чего он и как работает.

Вы серьёзно это говорите про геттер? Иначе не пойму.

> Вы хотели сказать об этом? 
https://github.com/php-fig/fig-standards/tree/master/accepted

Да, об этом.

> в остальном не пойму к чему "тыкание"

> по ссылке вы объявляете глобальные phpDoc-переменные $model, $modelId, $label, $comment, не имеющие отношения к классу

https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md#42-properties

MUST NOT