Add a missing filter documentation

[johnbillion]

What?

This is a duplicate filter that's missing its relevant inline doc.

Why?

Without this, the parser for the developer site sees this filter twice, once with its documentation and once without.

[michalczaplinski]

Hi @johnbillion! 👋

I'm a bit confused as to why this is necessary. As far as I understand packages/block-library/src/comments/index.php (the file that you edited) is copied over to WordPress core during the backport and package sync. After that it ends up in wp-includes/blocks/comments.php:

So, as far as I can tell, removing it in WordPress Core and adding it in Gutenberg is going to work until the next WordPress release at which point that same file is going to be copied over from Gutenberg to Core again (including that comment).

I'm also puzzled as to why how this comment present in Core but absent in Gutenberg in the first place if the comments/index.php is supposed to be just copied over verbatim 🤔 .

[johnbillion]

@michalczaplinski The comment doesn't exist in WordPress core, it got added accidentally in WordPress/wordpress-develop@1af2c8b and reverted in WordPress/wordpress-develop@4a3d6ff in favour of making the change here which will allow it to get correctly copied into core.

[michalczaplinski]

Got it - that makes sense now! 😃