Suggestion Regarding PHPDoc Usage for $GLOBALS in WordPress Core

[viralsampat]

Hello Team,

I hope you're doing well.

While reviewing the WordPress Core files, I noticed the usage of PHPDoc blocks for certain global variables like "_wp_tests_development_mode". However, I found that other global variables such as debug are not consistently documented using PHPDoc.

I believe adding PHPDoc comments for these globals can improve code readability, assist with static analysis tools, and enhance overall documentation clarity. It might be worth considering standardizing this across the Core codebase.

Thank you

[viralsampat]

I have checked above mentioned issue and resolved it. Here, I have added my patch.

[sabernhardt]

#60021 proposed documenting $_wp_tests_development_mode, but the ticket was closed without updating that.

• If it should be done, the @global would belong before @return, as in 60021.16.patch.
• [56042] added the global variable.

[19935] deprecated the debug_fwrite() function, and the $debug variable could have been either 1 or true (int|bool).