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

[WordPress Trac]

#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):

 Replying to [comment:27 dustyf]:
 > Question: For a duplicate hook, how do we know which instance of the
 hook should be documented and which should be marked duplicate?  Also, I
 know the standard being used is {{{ // Duplicate hook }}}, but would it
 make sense to have some reference to where it is documented so someone
 could more easily find it?

 The standard being used is '''very specifically''' `//duplicate_hook` (no
 space, underscore between the words).

 And you'd want to search for multiplies of the same hook tag and svn blame
 those lines to find the "first" use of it in terms of earliest revision.
 The first use gets a docblock, the second (third, fourth, etc) get
 `//duplicate_hook`.

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