Why we should use phpdoc with netbeans

It's said that a good developer learns something about his IDE every day, today I start coding again after a long pause doing management and a feature of netbeans greatly surprised me.

When using object oriented programming in PHP is easy to loose track of the type of object we're handling, plus the code completion of IDEs is very poor because of the polyphormic features in PHP.

Here enters a good documentation, I always ask every developer I work with to write phpdoc in any function they made, now another feature of netbeans make it more important, the pseudo class completion makes the IDE know what type of object is returning a function, allowing a fully working autocomplete even in funciton chains.

Good documentation plus good IDE equals great productivity.