Reported by andfinally via User Contributed Notes.

Issue Description

The description of the $tax_input in the docblock for this function is ambiguous – it doesn’t mention that you can pass an array of term IDs for a non-hierarchical taxonomy.

URL of the Page with the Issue

https://developer.wordpress.org/reference/functions/wp_insert_post/#parameters

Section of Page with the issue

Parameters

Why is this a problem?

Misrepresents the accepted values of tax_input.

Suggested Fix

Review and verify accepted values of tax_input are properly documented.