Q:

Как добавить PHPdoc comment к уже существующий функции в PhpStorm? 

Есть функция, у которой например 7 параметров, каждый из параметров подробно описан в комментариях Phpdoc над функцией в т.ч.  вручную (для каждой переменной дописаны типы данных возможные и описание) + общее описание того что делает функция. 
При дописывании или правках функции если какой-то параметр меняется, то комментарий самостоятельно не обновляется и не генерируется дополнительная строка с описанием параметра как это делается при первичном создании описания функции (хоткей /** над функцией).  
Как сделать чтобы добавлялся/генерился, не потеряв существующего описания? 

A:

Изменение, не отраженное в phpdoc будет подчеркнуто волнистой линией.  Если установить курсор на эту переменную, то в появившейся "лампочке" появится меню "Update PHPDoc Comment".  При выборе этого меню комментарий обновится

Если в комментарии не хватает, например, тега return, то подчеркнут будет весь комментарий.  Изменяется комментарий таким же образом, через выпадающее меню

