id summary reporter owner description type status priority milestone component version severity resolution keywords cc focuses 31747 wp_insert_comment better docstrings lamosty DrewAPicture "Function wp_insert_comment has incomplete docstring documentation. [https://core.trac.wordpress.org/browser/trunk/src/wp-includes/comment.php#L2087 Its docstring] says {{{ The available comment data key names are 'comment_author_IP', 'comment_date', 'comment_date_gmt', 'comment_parent', 'comment_approved', and 'user_id'. }}} but the function accepts additional arguments through ''$commentdata'' assoc array, such as ''comment_type'' or ''comment_content''. Docstring could be enhanced to have a format like in the case of ''wp_insert_post'' function (=> argument type with a short description of what the argument does)." defect (bug) closed normal 4.3 Comments normal fixed has-patch docs