'wp_refresh_nonces' filter missing docs

[dlh]

As far as I can see, at least. The filter appears in wp_ajax_heartbeat().

[slushman]

Adds PHPDocs to the wp_refresh_nonces filter.

[slushman]

Uploaded patch that adds PHPDocs documentation to the wp_refresh_nonces filter.

[netweb]

Thanks for the patch @slushman, it needs a couple of tweaks per our PHPDocs coding standards alignment, in particular the spacing of the @param lines:

You can read about those here: ​https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/php/#docblock-formatting

[chetan200891]

Updated patch based on PHPDocs coding standards alignment.

[chetan200891]

@netweb Updated patch 42777-updated.diff added as per your suggestion to tweak PHPDocs coding standards alignment.

[obenland]

In 42717:

Docs: Add filter docs for wp_refresh_nonces

Props chetan200891, slushman, dlh, netweb.
Fixes #42777.

[SergeyBiryukov]

In 42720:

Docs: Correct documentation for Heartbeat filters.

$response parameter is documented as an array or object, but only array is actually supported.

See #42777, #42505.