WP_Customize_Panel::__construct() is missing `$args` documentation

[marekdedic]

Documentation for the fields of the $args argument is missing:

​https://developer.wordpress.org/reference/classes/wp_customize_panel/__construct/

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

​https://developer.wordpress.org/reference/classes/wp_customize_manager/add_panel/

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.

[marekdedic]

Also, I believe the type of theme_supports should be string|string[] instead of just string|array ;)

[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...

[SergeyBiryukov]

Related: #48346, #48347.

[iaaxpage]

Patch with the arguments for the constructor

[iaaxpage]

Arguments for the constructor

[SergeyBiryukov]

In 47387:

Docs: Add a reference to WP_Customize_Panel::__construct() for information on accepted arguments in WP_Customize_Manager::add_panel().

Synchronize the documentation between two places, use WP_Customize_Panel::__construct() as the canonical source.

Props iaaxpage, marekdedic.
Fixes #48344.