Have a Zend_CodeGenerator_Php_Docblock_Tag_Property to create @property in doc blocks as well. Auto generated @property's good drasticly improve ease-of-coding. Zend_CodeGenerator_Php_Docblock_Tag_Property code should completely identical to Zend_CodeGenerator_Php_Docblock_Tag_Param; better integrate param/property functionality into Zend_CodeGenerator_Php_Docblock_Tag and use Zend_CodeGenerator_Php_Docblock_Tag_Param. Use Zend_CodeGenerator_Php_Docblock_Tag_Property as a kind of type selector. This would also improve the handling of tags for you wouldn't have to switch between various types of tags.