Adjust wp_insert_post() docs to reflect that the post_category argument will only accept one or more term IDs

[DrewAPicture]

As pointed out by @ck-macleod on the Code Reference, the post_category argument for wp_insert_post() actually only accepts term IDs and not an "Array of category names, slugs, or IDs."

This is due to how adding hierarchical taxonomies terms (like categories) works up the stack in wp_insert_post() -> wp_set_post_categories() -> wp_set_post_terms().

 *     @type array  $post_category         Array of category names, slugs, or IDs.

The fix should remove reference to "names" and "slugs" in the $post_category entry in the hash notation for wp_insert_post().

[Takahashi_Fumiki]

Fix doc comment of wp_insert_post and wp_set_post_categories.

[Takahashi_Fumiki]

Fix doc comment of wp_insert_post.
Besides that, doc comment of wp_set_post_categories is also vague(List of categories), so I fixed it's more concrete List of category IDs.

[DrewAPicture]

Assigning to mark the good-first-bug as "claimed".

Hi @Takahashi_Fumiki, thanks for the patch! Everything looks good here.

Trunk development is still ​closed pending the 5.0 release, but we should be able to get this in with 5.1.

[Takahashi_Fumiki]

@DrewAPicture Thanks for your rebiew! I got what you said:)

[pento]

In 44660:

Docs: Improve the docblocks for wp_insert_post() and wp_set_post_categories().

Their respective post_category and post_categories parameters were not correct.

Props Takahashi_Fumiki.
Fixes #45171.

[Hareesh Pillai]

#38435 was marked as a duplicate.