First of all a silde to this topic:

http://de.slideshare.net/rdohms/annotations-in-php-they-exist