ввел какие-то символы и у тебя сразу комментарий из нескольких строк появился?  типа таких 
                  
                  
                  /**
                  
                  
                       * @var ImageService
                  
                  
                       */
                  
                  
                  или даже таких как на скрине?  https://i.imgur.com/JmUmRDm.png
                  
                  
                
На скрине моделька laravel'a, сгенерировано через ide-helper скорее всего
да. коллега поработал недолго у нас в компании и нагенерировал в каждых моделях такой код и уволился а я так и не успел вникнуть. он говорил что это позволяет ему устанавливать связи между моделями без создания дополнительного кода в тексте моделей
И что вы понимаете под "правильным комментированием", можете посмотреть PHPDoc конструкции, ещё есть psalm'овские. Эти ж комментарии просто подсказки для ide/стат анализаторов
я видел в ide как то можно генерировать комментарии для тех же функций и переменных. чтоб тип переменной опять же указывался в комментарии
> он говорил что это позволяет ему устанавливать связи между моделями без создания дополнительного кода в тексте моделей Либо он наврал, либо ты неправильно его понял.
Обсуждают сегодня