[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

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