Add missing docs for the $data parameter for WP_Http::browser_redirect_compatibility()

[ronakganatra]

Documentation needs improvement.parameter passed but not defined.

[ronakganatra]

documentation added for parameter which is passed but not defined.

[DrewAPicture]

In 41218:

Docs: Add missing documentation for the $data parameter for WP_Http::browser_redirect_compatibility().

Props ronakganatra for the initial patch.
Fixes #41380.

[DrewAPicture]

Hi @ronakganatra, thanks for the patch. I've gone ahead and merged part of your patch and wanted to give you a couple of pointers for future tickets:

1) It would be very helpful if you could try to write more specific ticket summaries when submitting to trac in the future. I went ahead and updated it for you here :-)

2) It would also be helpful to generate your patches from the WordPress root instead of the directory the file is located in. This is because most core contributors will be using tools like the ​grunt patch tool to apply patches, which means patches not generated from the root may not apply correctly.

[SergeyBiryukov]

This description appears to be a copy/paste from wp_cache_add(),

The $data argument of WP_Http::browser_redirect_compatibility() has nothing to do with cache, appears to be unused and could probably be deprecated to avoid further confusion. Introduced in [37428].

[SergeyBiryukov]

In 41907:

Docs: Correct type and description for the $data parameter in WP_Http::browser_redirect_compatibility().

Fixes #41380.