Фон:
PHPDoc ( http://www.phpdoc.org/ ) — отличный инструмент для извлечения html-документации ваших классы или методы из комментариев в ваших файлах. Добавление комментариев PHPDoc также имеет другие преимущества: если вы используете IDE, такую как Zend или Netbeans, она будет использовать PHPDocs, чтобы показать вам советы по автозаполнению.
В большинстве систем отслеживания проблем есть функция, с помощью которой вы можете зафиксировать в своей системе управления версиями специальный комментарий, и она автоматически свяжет эту фиксацию с этой проблемой.
Итак, вот что я хочу от системы: я фиксирую некоторый код со специальным комментарием, и мой трекер проблем связывает его с проблемой. Затем он просматривает коммит и выясняет, какие методы и классы я изменил. Затем он говорит: «Если вы ищете документацию по этой проблеме, попробуйте эти фрагменты PHPDoc: ClassX.FunctionY, ClassZ.VariableP». Он автоматически указывает пользователям на документацию, которая может быть актуальной. Я думаю, что это была бы отличная функция.
Вопрос:
Таким образом, часть, которой не хватает, - это то, что нужно сравнить с PHP-кодом и выяснить, какие классы и методы изменились. У кого-нибудь есть какие-либо указатели на какой-то код, который может это сделать?
Заранее спасибо, Джеймс