Is @package required with PHP 5.3 namespaces?

I switched to PHP 5.3 and namespaces. It seems that the @package tag is now superfluous and useless.

Is phpDoc required yet, or can I ignore this tag now?

thanks

+4
source share
2 answers

This is not required.

The last document now states that @package should be avoided if you use a namespace and you don't need another structure for documentation:

If, in all areas, the logical and functional units are NOT RECOMMENDED to use the @package tag to prevent maintenance overhead.

http://phpdoc.org/docs/latest/references/phpdoc/tags/package.html

+3
source

@package does not apply to namespaces, but to organize the resulting documentation.

Packages are used to help you logically group related items. phpDoc guide

EDIT

Is there a replacement PHPDocumentor that supports PHP 5.3?

+1
source

Source: https://habr.com/ru/post/1345595/


All Articles