Docs: Correct WP_Network_Query params comments

[baikare.sandeep007]

This patch improves the inline documentation for the WP_Network_Query class:

• Clarifies and corrects PHPDoc blocks for class properties, specifying types and expected values.
• Updates the constructor’s parameter documentation to reference the accepted arguments and their types.
• Improves descriptions for complex array properties and return values, especially for query variables and results.
• Enhances code readability and assists developers and IDEs with more accurate type information.

These changes are documentation-only and do not affect runtime behavior.

[baikare.sandeep007]

network query comment documentation improvements

[westonruter]

@baikaresandeep007 Thanks for the ticket. Would you please submit the patch as a pull request instead? This will facilitate review.

Trac ticket: https://core.trac.wordpress.org/ticket/65118

## Use of AI Tools

Thanks @westonruter, created PR as requested.

@westonruter accepted suggestions. Thanks

[westonruter]

Queueing up for 7.1

[wildworks]

Please feel free to commit a patch at any time.

This reduces the PHPStan level 10 error count from 61 to 56.

[westonruter]

In 62721:

Docs: Add specific types to WP_Network_Query properties.

Replace the generic array type in the docblocks for the $sql_clauses, $query_vars, $query_var_defaults, and $networks properties with specific types, including an array shape for $sql_clauses and WP_Network[]|int[] for $networks. Additionally, document the $found_networks and $max_num_pages counts as non-negative-int.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11663.
Follow-up to r37894.

Props baikaresandeep007-1, westonruter.
See #64896.
Fixes #65118.