diff --git a/src/wp-admin/includes/media.php b/src/wp-admin/includes/media.php
index e569040138..75811962f9 100644
--- a/src/wp-admin/includes/media.php
+++ b/src/wp-admin/includes/media.php
@@ -3027,9 +3027,11 @@ function wp_read_audio_metadata( $file ) {
  *
  * @since 4.2.0
  *
- * @global wpdb $wpdb
- * @param int    $parent_id
- * @param string $action
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
+ * @param int    $parent_id Attachment parent ID.
+ * @param string $action    Optional. Attach/detach action. Accepts 'attach' or 'detach'.
+ *                          Default 'attach'.
  */
 function wp_media_attach_action( $parent_id, $action = 'attach' ) {
 	global $wpdb;