[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