[wp-trac] [WordPress Trac] #42509: Document expected parameters passed to callback functions

[WordPress Trac]

#42509: Document expected parameters passed to callback functions
-------------------------+-----------------------------
 Reporter:  johnbillion  |       Owner:
     Type:  enhancement  |      Status:  new
 Priority:  normal       |   Milestone:  Future Release
Component:  General      |     Version:
 Severity:  minor        |  Resolution:
 Keywords:  has-patch    |     Focuses:  docs
-------------------------+-----------------------------

Comment (by johnbillion):

 It's worth noting that in the (very old) PSR-5 draft, a syntax for
 `@method` notation was proposed which effectively documents callable
 parameters, but it's pretty nasty, and PSR-5 hasn't had any traction in
 several years. See https://github.com/phpDocumentor/fig-
 standards/blob/master/proposed/phpdoc.md#711-method

--
Ticket URL: <https://core.trac.wordpress.org/ticket/42509#comment:1>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform