[wp-trac] [WordPress Trac] #48346: WP_Customize_Section::__construct() is missing `$args` documentation

[WordPress Trac]

#48346: WP_Customize_Section::__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         |   Keywords:
  Focuses:  docs          |
--------------------------+-----------------------------
 Documentation for the fields of the `$args` argument is missing:

 https://developer.wordpress.org/reference/classes/wp_customize_section/__construct/

 I believe a good starting point would be the documentation of
 `WP_Customize_Manager::add_section()`:

 https://developer.wordpress.org/reference/classes/wp_customize_manager/add_section/

 Although I am not sure about the correctness of what's in there. But from
 the implementation of add_panel, I'd say they should match.

 As per https://make.wordpress.org/core/handbook/best-practices/inline-
 documentation-standards/php/#1-1-parameters-that-are-arrays, there should
 only be a `@see` comment in `add_section` and the documentation should be
 in the constructor I believe.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/48346>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform