[wp-trac] [WordPress Trac] #25514: Hook Docs: wp-includes/query.php

[WordPress Trac]

#25514: Hook Docs: wp-includes/query.php
--------------------------+------------------------------
 Reporter:  dougwollison  |       Owner:  DrewAPicture
     Type:  enhancement   |      Status:  reviewing
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Inline Docs   |     Version:
 Severity:  normal        |  Resolution:
 Keywords:  needs-patch   |
--------------------------+------------------------------

Comment (by dougwollison):

 Done, however in terms of documenting variables that "don't exist", it
 still goes back to the fact that we're documenting how the hook is used;
 the exact name of the parameter doesn't matter, as it's getting passed to
 another function that may use it's only naming for it.

 We almost don't need to name the variables at all; just the type and a
 description. It's more like a @return tag than a @param tag in some ways.

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