[wp-trac] [WordPress Trac] #27200: Remove all non-file-level @package/@subpackage tags
WordPress Trac
noreply at wordpress.org
Tue Feb 25 11:16:50 UTC 2014
#27200: Remove all non-file-level @package/@subpackage tags
--------------------------+------------------------------
Reporter: DrewAPicture | Owner:
Type: defect (bug) | Status: new
Priority: normal | Milestone: Awaiting Review
Component: General | Version:
Severity: normal | Resolution:
Keywords: has-patch | Focuses: docs
--------------------------+------------------------------
Comment (by DrewAPicture):
Replying to [comment:1 Rarst]:
> Note that it is _valid_ for class (top level class phpdoc). It's only
invalid for functions (and methods I assume since that doesn't make
sense). Of course if file header has package already repeating it in class
is just redundant.
I talked to @kpdesign about this yesterday and we both agree the better
option would be to only have package tags in the file headers, i.e. once
per file.
The consensus was to promote a clean, simple standard instead of "package
tags go in the file header except in (this), (this), or (this) instance.
If we just stick with only using package tags in file headers I think it
will create far less confusion going forward.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/27200#comment:2>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list