Correction for the docs of wp_list_authors()

[birgire]

Regarding the wp_list_author() docs:

• The description of exclude is duplicated but there's none of include.

• The input type for include and exclude can be either a string or an array. (see wp_parse_list_id() ). Currently it's documented only as a string.

[birgire]

Regarding the patch: I additionally improved the readability (alphabetical order + one argument per line)

[rachelbaker]

@birgire Thanks for the patch. Let's keep the patch limited to the changes for the @include and @exclude params. Can you refresh it without the alphabetical re-ordering?

[rachelbaker]

Introduced in [28909]. See #28684

[birgire]

Without alphabetical ordering

[birgire]

@rachelbaker sure, I updated the patch without the alphabetical ordering.

ps:

What's the preferred order?

I'm not sure pure code readability adjustments, like

• alphabetical ordering of array arguments
• single argument per line in an array

are accepted as tickets, so I added them here with this ticket ;-)

Mainly because I think it makes it easier (in general) to skim through the core code.

[SergeyBiryukov]

In 37949:

Docs: In wp_list_authors(), clarify that include and exclude arguments can also be an array.

Fix duplicated exclude argument description.

Props birgire.
Fixes #37239.