Default argument documentation for WP_Comment_Query

[boonebgorges]

Attached patch adds documentation for WP_Comment_Query default arguments.

[DrewAPicture]

In 30110:

Update the changelog for WP_Comment_Query::query() to reflect two more new arguments added in [30096].

[30096] introduced the type__in and type__not_in arguments. See #30111 for documentation on those new arguments.

Fixes #12668.

[DrewAPicture]

@boonebgorges: Care to add the type__in and type__not_in parameters to your patch?

[boonebgorges]

Avec plaisir. Attached for your review.

[DrewAPicture]

In 30280:

Document default arguments for WP_Comment_Query class as a hash notation.

Props boonebgorges, DrewAPicture.
See #30111.

[DrewAPicture]

In 30281:

Cross-reference WP_Comment_Query::query() as the location for finding information on default arguments for WP_Comment_Query.

Also updates the return types on get_comments() and get_approved_comments(), as an integer can also be returned if the $count argument is true.

Fixes #30111.