PHPDoc: как поступаете при изменении кода?

[Toshka]

PHPDoc: как поступаете при изменении кода?

Допустим, есть функция, которая уже прокомментирована в стиле phpdoc. Дальше что нить дописываем и описание\действия функции меняются - как это отображаете в комментарии при условии, что сразу описание не менять, а то мысль уйдет Частенько бывает... Потом можно и не вспомнить, что нужно исправить
Сейчас стал смотреть "svn status" - можно сразу по списку глазами пройтись и вспомнить. А вы как делаете?

 

[zerkms]

можно помечать через * @todo
хотя - на практике лучше менять всё сразу, а то и вправду теряется

 

[ys]

У себя "svn diff" и !TODO
последнее время, вместо !TODO хорошо работает !XXX

В связи с тем, что vim реагирует на это сочетание, как бых на торреодора

 

[Alexandre]

хотя - на практике лучше менять всё сразу, а то и вправду теряется

+1
меняю сразу, даже если функция временная.
документация генерится два раза в раб день по крону. т.е. под рукой всегда актуальная документация.

 

[boombick]

последнее время, вместо !TODO хорошо работает !XXX

у меня vim одинаково хорошо реагирует и на !TODO и на !XXX и на !FIXME