[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 bftrick):

 Replying to [comment:35 rmccue]:
 > Replying to [comment:34 bftrick]:
 > > Question. If a hook is in the middle of a block of HTML do you comment
 above the html or inside of it? I assume above it as it would be cleaner.
 > > [...]
 > > Another question. What if the hook is embedded in a long conditional?
 >
 > From a technical standpoint, [https://github.com/rmccue/WP-
 Parser/pull/28 WP-Parser#28] is tracking the implementation. For
 conditionals, you should be able to put it before the entire conditional,
 and likewise for embedded HTML, as it just holds on to the tag until the
 next action/filter it sees.

 thanks for the clarification! :)

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