clean_comment_cache needs a hook

[spacedmonkey]

Unlike other cache clear functions, clean_comment_cache doesn't have a hook.

[ericlewis]

Makes sense to me.

Do we want unit tests for this?

[rachelbaker]

@spacedmonkey Looks like there is some copypasta in the hook docs

Fires once after each taxonomy's term cache has been cleaned.

[spacedmonkey]

Third time's the charm

[spacedmonkey]

I don't think this requires unit tests no. Nice spot, @rachelbaker

[boonebgorges]

Replying to ericlewis:

Makes sense to me.

Do we want unit tests for this?

Don't need unit tests for an action in most cases.

35610.2.patch​ should have extraneous spaces in new @param documentation removed, and I don't think we need a function-level @since addition for this (the info is in the hook docblock).

[ericlewis]

In 36405:

Comments: Fire an action after a comment is removed from object cache.

When a comment is removed from the object cache, the clean_comment_cache action is now fired. This provides plugin and theme developers a chance to perform secondary cache invalidation as needed.

Props spacedmonkey.
Fixes #35610.

[DrewAPicture]

In 36922:

Docs: Improve the DocBlock summary for the clean_comment_cache action, introduced in [36405].

See #35610. See #35986.