WP: Improve various globals documentation, as per docblock standards.

[upadalavipul]

I have reviewed the WordPress code and found some of the files need to be improved with function commenting code. Please check the below files list.

Files:

1. wp-admin/includes/plugin.php
2. wp-includes/rss.php
3. wp-includes/widgets.php

[upadalavipul]

patch added

[audrasjb]

Thanks for the patch @upadalavipul.
However, the global in wp-admin/includes/plugin.php should be placed with the other globals listed in that global.

[audrasjb]

And we should use a description for $wp_version for consistency with other doblocks:
* @global string $wp_version The WordPress version string.

[audrasjb]

Same goes for $wp_registered_widgets:
* @global array $wp_registered_widgets The registered widgets.

[shailu25]

Updated Patch

[shailu25]

@audrasjb I have Updated Patch as per Mentioned Changes

For wp-admin/includes/plugin.php : Its already placed with other global listed in trunk.

Ref: ​https://prnt.sc/ubQvBzQjsUNG (In Trunk Version)

[shailu25]

Updated Patch

[shailu25]

I have Updated Patch.

Changed Description for $wp_registered_widgets in /wp-includes/widgets.php

• Used * @global array $wp_registered_widgets The registered widgets. for $wp_registered_widgets
• Used * @global array $wp_registered_sidebars The registered sidebars. for $wp_registered_sidebars

[nicolefurlan]

@audrasjb would you be able to review these updated patches to determine whether this ticket is ready for the next step?

[nicolefurlan]

I've dropped this ticket into #core-docs to hopefully get some eyes on these copy changes.

[nicolefurlan]

This ticket was discussed in today's bug scrub. Since they're code docs, they don't need copy review, they need code review.

@hellofromTonya will take a look at this!

[hellofromTonya]

The RC1 release party is about to start. Moving this to 6.5.

[viralsampat]

I have checked above mentioned issue and founds few files. Here, I have added its patch.

[audrasjb]

@viralsampat getid3.lib.php is in an external library and should be fixed upstream and duotone.php comes from Gutenberg and should also be fixed upstream. I'm going to commit patch 59255.4.patch.

[audrasjb]

In 57370:

Docs: Improve various globals documentation, as per docblock standards.

Props upadalavipul, audrasjb, shailu25, viralsampat.
Fixes #59255.
See #59651.