[wp-trac] [WordPress Trac] #48344: WP_Customize_Panel::__construct() is missing `$args` documentation (was: WP_Customize_Panel::__construct() is missing $args documentation)

WordPress Trac noreply at wordpress.org
Thu Oct 17 11:40:55 UTC 2019


#48344: WP_Customize_Panel::__construct() is missing `$args` documentation
--------------------------+------------------------------
 Reporter:  marekdedic    |       Owner:  (none)
     Type:  defect (bug)  |      Status:  new
 Priority:  normal        |   Milestone:  Awaiting Review
Component:  Customize     |     Version:  5.2
 Severity:  minor         |  Resolution:
 Keywords:                |     Focuses:  docs
--------------------------+------------------------------

Comment (by marekdedic):

 Also, as per https://make.wordpress.org/core/handbook/best-practices
 /inline-documentation-standards/php/#1-1-parameters-that-are-arrays, I
 believe in `WP_Customize_Manager::add_panel()`, the arguments
 **shouldn't** be explicitly documented, just with a `@see`...

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


More information about the wp-trac mailing list