The documentation of WP_Comment_Query is incorrect

[dinhtungdu]

See: ​https://developer.wordpress.org/reference/classes/wp_comment_query/#more-information

When you create an instance of this class passing an array of arguments to it’s constructor, the class will automatically run the query method and return an array of comments.

This is incorrect, when we create an instance of WP_Comment_Query with non-empty argument, the class always returns an instance of WP_Comment_Query, not an array of comments. This leads to incorrect example of ​basic usage as well.

[audrasjb]

Hi @dinhtungdu and thank you for spotting this,

I updated "Basic usage" section on DevHub accordingly: ​https://developer.wordpress.org/reference/classes/wp_comment_query/

[audrasjb]

Closing this ticket as reported-upstream since it doesn't require changes on WordPress core.
Thanks again, @dinhtungdu!