> Эти комментарии - визуальный мусор

не согласен. в данном случае, да, менее информативно. но заложилось ради того, чтобы дополнить в последствии, когда будет необходимость вернуться. И нет, я не согласен, по поводу "визуального мусора", так как хотя бы "маломайски" можно понять к чему этот метод, а здесь я вижу лишь метод и мне приходится копаться в коде, чтобы понять для чего он и как работает.
Не спорю по информативности, спорю о том, что стоит закладывать в код комментарии, которые можно заполнить сейчас или, если уж совсем тяжко - в последующих коммитах. 

>  прочтите перед использованием "плагин для проверки кода "

Вы хотели сказать об этом? 
https://github.com/php-fig/fig-standards/tree/master/accepted

Да, читал, использую. Плагин лишь для самопроверки, если уже совсем заморочился.

К чему споры? я не пойму?

> phpStorm
в свою очередь, я пользуюсь лишь сублайм, головой и заглядываю на стандарты ( https://github.com/php-fig/fig-standards/tree/master/accepted ).
То что вы указали на использование @method - да, уже пояснил, читайте выше. в остальном не пойму к чему "тыкание"?