Допустим вы изменили сигнатуру функции или метода и PhpStorm стал подсвечивать docblock волнистой линией, намекая на то, что он не соответствует актуальной сигнатуре. И как быть, неужели править phpdoc ручками? К счастью, нет! Достаточно навести курсор на docblock и нажать комбинацию клавиш Alt + Enter для вызова меню Intention Actions. Как правило, можно сразу же нажать Enter для выбора первого пункта из меню.
Далее выбрать необходимый способ автоматического приведения комментария в актуальный вид. Это же меню можно вызвать нажатием на кнопку с иконкой зажжёной лампочки, которая со временем появляется рядом с устаревшим комментарием. Горячие клавиши для данного меню можно изменить в настройках: Settings -> Keymap, затем Other -> Show Intention Actions.