docs: Add missing parameter descriptions to docblocks

Author: rejaulalomkhan

src/wp-admin/includes/ajax-actions.php

@@ -454,8 +454,8 @@ function wp_ajax_logged_in() {
  * @since 2.7.0
  * @access private
  *
- * @param int $comment_id
- * @param int $delta
+ * @param int $comment_id Comment ID.
+ * @param int $delta      Change in the number of total comments. Default -1.
  */
 function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
 	$total    = isset( $_POST['_total'] ) ? (int) $_POST['_total'] : 0;

src/wp-admin/includes/class-wp-importer.php

@@ -289,9 +289,9 @@ public function stop_the_insanity() {
  * Returns value of command line params.
  * Exits when a required param is not set.
  *
- * @param string $param
- * @param bool   $required
- * @return mixed
+ * @param string $param    The parameter name to retrieve.
+ * @param bool   $required Whether the parameter is required. Default false.
+ * @return mixed The parameter value if found, null otherwise.
  */
 function get_cli_args( $param, $required = false ) {
 	$args = $_SERVER['argv'];

src/wp-admin/install.php

@@ -52,7 +52,7 @@
  *
  * @since 2.5.0
  *
- * @param string $body_classes
+ * @param string $body_classes CSS classes to add to the body tag.
  */
 function display_header( $body_classes = '' ) {
 	header( 'Content-Type: text/html; charset=utf-8' );
@@ -85,7 +85,7 @@ function display_header( $body_classes = '' ) {
  *
  * @global wpdb $wpdb WordPress database abstraction object.
  *
- * @param string|null $error
+ * @param string|null $error Error message to display, if any.
  */
 function display_setup_form( $error = null ) {
 	global $wpdb;

src/wp-admin/nav-menus.php

@@ -672,12 +672,14 @@
 }
 
 /**
+ * Adds a CSS class to display the max depth of the navigation menu.
+ *
  * @since 3.0.0
  *
- * @global int $_wp_nav_menu_max_depth
+ * @global int $_wp_nav_menu_max_depth Maximum depth of the navigation menu.
  *
- * @param string $classes
- * @return string
+ * @param string $classes Existing CSS classes for the body tag.
+ * @return string Modified CSS classes including the menu max depth class.
  */
 function wp_nav_menu_max_depth( $classes ) {
 	global $_wp_nav_menu_max_depth;

src/wp-admin/update-core.php

@@ -840,7 +840,7 @@ function list_translation_updates() {
  *
  * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass.
  *
- * @param bool $reinstall
+ * @param bool $reinstall Optional. Whether to reinstall WordPress. Default false.
  */
 function do_core_upgrade( $reinstall = false ) {
 	global $wp_filesystem;