[wp-trac] [WordPress Trac] #25229: Add Inline Docs for Hooks
WordPress Trac
noreply at wordpress.org
Wed Sep 18 08:08:31 UTC 2013
#25229: Add Inline Docs for Hooks
----------------------------+------------------
Reporter: rzen | Owner:
Type: task (blessed) | Status: new
Priority: normal | Milestone: 3.7
Component: Inline Docs | Version:
Severity: normal | Resolution:
Keywords: |
----------------------------+------------------
Comment (by netweb):
Replying to [comment:74 DrewAPicture]:
> [attachment:wp-links-opml.diff] — @netweb:
> * `opml_head` action: Space it out per coding standards, and drop the
`?>` to a new line. Also, the short description should describe when it
fires, e.g. "Fires in the OPML head." or something
> * Anytime you find yourself writing "Allows you to filter something",
just use "Filter something". "Allows you to" makes an implication about
''how'', instead of ''what''
> * `@param` lines 54, 69 need a period after the short description
> * Spacing issues with the docblock for `link_title` L#64
Thanks for the feedback :) Fixed in
http://core.trac.wordpress.org/attachment/ticket/25229/wp-links-
opml.2.diff
--
Ticket URL: <http://core.trac.wordpress.org/ticket/25229#comment:81>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software
More information about the wp-trac
mailing list