diff --git a/src/wp-includes/comment.php b/src/wp-includes/comment.php
index dfe5173236..9d998fc266 100644
--- a/src/wp-includes/comment.php
+++ b/src/wp-includes/comment.php
@@ -2316,7 +2316,7 @@ function wp_set_comment_status( $comment_id, $comment_status, $wp_error = false
  * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param array $commentarr Contains information on the comment.
- * @return int Comment was updated if value is 1, or was not updated if value is 0.
+ * @return int The value 1 if the comment was updated, 0 if not updated.
  */
 function wp_update_comment( $commentarr ) {
 	global $wpdb;
diff --git a/tests/phpunit/includes/factory/class-wp-unittest-factory-for-comment.php b/tests/phpunit/includes/factory/class-wp-unittest-factory-for-comment.php
index 7f504f7b3b..17f37437ce 100644
--- a/tests/phpunit/includes/factory/class-wp-unittest-factory-for-comment.php
+++ b/tests/phpunit/includes/factory/class-wp-unittest-factory-for-comment.php
@@ -27,7 +27,7 @@ class WP_UnitTest_Factory_For_Comment extends WP_UnitTest_Factory_For_Thing {
 	 *
 	 * @param array $args The comment details.
 	 *
-	 * @return false|int The comment's ID on success, false on failure.
+	 * @return int|false The comment's ID on success, false on failure.
 	 */
 	public function create_object( $args ) {
 		return wp_insert_comment( $this->addslashes_deep( $args ) );
@@ -39,7 +39,7 @@ class WP_UnitTest_Factory_For_Comment extends WP_UnitTest_Factory_For_Thing {
 	 * @param int   $comment_id The comment ID.
 	 * @param array $fields     The comment details.
 	 *
-	 * @return int When updated 1, not update 0.
+	 * @return int The value 1 if the comment was updated, 0 if not updated.
 	 */
 	public function update_object( $comment_id, $fields ) {
 		$fields['comment_ID'] = $comment_id;