[wp-trac] [WordPress Trac] #25229: Add Inline Docs for Hooks

WordPress Trac noreply at wordpress.org
Fri Sep 13 19:34:17 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 DrewAPicture):

 @mordauk:

 First, please don't overwrite old patches with the new ones, makes it hard
 to track progress and context of comments.

 Both [attachment:comment-php.patch] and [attachment:export-php.patch] are
 looking pretty good. One thing left:
 * When you're documenting a filter, if you find yourself saying "The
 whatever value", in the short description, it should really be "Filter the
 whatever value". Yes, the `apply_filters()` call does in-effect evaluate
 to that value, but the point is that's it's a filter doc, and not just a
 statement of value :)

--
Ticket URL: <http://core.trac.wordpress.org/ticket/25229#comment:53>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software


More information about the wp-trac mailing list