[wp-trac] [WordPress Trac] #31605: Action Omnibus: assorted useful actions and filters
WordPress Trac
noreply at wordpress.org
Thu Mar 12 15:01:21 UTC 2015
#31605: Action Omnibus: assorted useful actions and filters
-----------------------------+------------------------------
Reporter: tellyworth | Owner:
Type: enhancement | Status: new
Priority: normal | Milestone: Awaiting Review
Component: General | Version: trunk
Severity: normal | Resolution:
Keywords: has-patch close | Focuses:
-----------------------------+------------------------------
Changes (by DrewAPicture):
* keywords: has-patch => has-patch close
Comment:
Hi @tellyworth, thanks for the patch. Some notes on [attachment:action-
omnibus-1.diff]:
* Any new parameters added to hooks need corresponding changelog entries
in the hook docs, e.g. addition `@since` entries for the current version
mentioning that the parameter was added
* `@since` versions should use the 3-digit, x.x.x style
* Parameter descriptions should end with a period
* Parameter types, variables, and descriptions should be vertically
aligned with spaces, each section separated by a single space and wrapped
at the 80-120 character mark, no tabs inside of the DocBlocks
* There should be a blank line directly before a hook doc if the line
above is equally indented
* Hooks should be only have a corresponding DocBlock in one location, with
duplicate comments pointing to the file where the original is located
(even if it's in the same file), e.g. `/** This filter|action is
documented in path/to/file.php`
* Hook lines should follow core coding standards for spacing
All that said, realistically, these actions and filters should be
submitted via individual tickets since they span several different files
and components.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/31605#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list