Update proposal in phpDoc guidelines

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

Update proposal in phpDoc guidelines

Maks3w
Hi at all,

With the recent changes in phpDoc documentation the following tags are now deprecated.

  @category
  @subpackage

And the following change his behavior to the same of namespace statement

  @package


That tags was used to organize the API docs when namespaces doesn't exists and now are redundant with the use of namespace statements.

So we can go rid with @package, @subpackage and @category for ZF 2.1

If someone has some opinion against this change please be free of comment.

Regards
Reply | Threaded
Open this post in threaded view
|

Re: Update proposal in phpDoc guidelines

Sascha-Oliver Prolic
+1 on this!


2012/11/16 Maks3w <[hidden email]>
Hi at all,

With the recent changes in phpDoc documentation the following tags are now deprecated.

  @category
  @subpackage

And the following change his behavior to the same of namespace statement

  @package


That tags was used to organize the API docs when namespaces doesn't exists and now are redundant with the use of namespace statements.

So we can go rid with @package, @subpackage and @category for ZF 2.1

If someone has some opinion against this change please be free of comment.

Regards



--
Sascha-Oliver Prolic