Build/Test Tools: Derive element shapes for T[] hashes and read a Required. hash marker

src/wp-admin/includes/template.php

@@ -1907,7 +1907,7 @@ function add_settings_error( $setting, $code, $message, $type = 'error' ) {
  *         @type string $code    Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
  *         @type string $message The formatted message text to display to the user (will be shown inside styled
  *                               `<div>` and `<p>` tags).
- *         @type string $type    Optional. Message type, controls HTML class. Possible values include 'error',
+ *         @type string $type    Message type, controls HTML class. Possible values include 'error',
  *                               'success', 'warning', 'info'. Default 'error'.
  *     }
  * }

src/wp-includes/blocks.php

@@ -1928,8 +1928,40 @@ function traverse_and_serialize_block( $block, $pre_callback = null, $post_callb
  * @since 6.6.0
  * @since 7.0.0 Adds metadata to attributes of single-pattern container blocks.
  *
- * @param array $blocks An array blocks.
- * @return array An array of blocks with patterns replaced by their content.
+ * @param array[] $blocks {
+ *     An array of blocks.
+ *
+ *     @type array ...$0 {
+ *         An associative array of a single parsed block object. See {@see WP_Block_Parser_Block}.
+ *
+ *         @type string|null $blockName    Required. Name of block.
+ *         @type array       $attrs        Required. Attributes from block comment delimiters.
+ *         @type array[]     $innerBlocks  Required. List of inner blocks. An array of arrays that
+ *                                         have the same structure as this one.
+ *         @type string      $innerHTML    Required. HTML from inside block comment delimiters.
+ *         @type array       $innerContent Required. List of string fragments and null markers where
+ *                                         inner blocks were found.
+ *     }
+ * }
+ * @return array[] {
+ *     An array of blocks with patterns replaced by their content.
+ *
+ *     @type array ...$0 {
+ *         An associative array of a single parsed block object. See {@see WP_Block_Parser_Block}.
+ *
+ *         @type string|null $blockName    Name of block.
+ *         @type array       $attrs        Attributes from block comment delimiters.
+ *         @type array[]     $innerBlocks  List of inner blocks. An array of arrays that
+ *                                         have the same structure as this one.
+ *         @type string      $innerHTML    HTML from inside block comment delimiters.
+ *         @type array       $innerContent List of string fragments and null markers where
+ *                                         inner blocks were found.
+ *         @type mixed       ...$key       Any other keys a block passed in carries, which
+ *                                         are kept, except where a `core/pattern` block is
+ *                                         replaced by its pattern's blocks, or removed as
+ *                                         recursive.
+ *     }
+ * }
  */
 function resolve_pattern_blocks( $blocks ) {
 	static $inner_content;

src/wp-includes/general-template.php

@@ -4073,7 +4073,8 @@ function wp_preload_resources() {
 	 *     @type array ...$0 {
 	 *         Array of resource attributes.
 	 *
-	 *         @type string $href          URL to include in resource preloads. Required.
+	 *         @type string $href          URL to include in resource preloads. May be omitted
+	 *                                     for an image preloaded by its `$imagesrcset`.
 	 *         @type string $as            How the browser should treat the resource
 	 *                                     (`script`, `style`, `image`, `document`, etc).
 	 *         @type string $crossorigin   Indicates the CORS policy of the specified resource.

src/wp-includes/ms-site.php

@@ -646,7 +646,9 @@ function wp_validate_site_data( $errors, $data, $old_site = null ) {
  * @param array       $args    {
  *     Optional. Arguments to modify the initialization behavior.
  *
- *     @type int    $user_id Required. User ID for the site administrator.
+ *     @type int    $user_id User ID for the site administrator. Default 0, in which
+ *                           case the site is created without an administrator
+ *                           and with an empty admin email address.
  *     @type string $title   Site title. Default is 'Site %d' where %d is the
  *                           site ID.
  *     @type array  $options Custom option $key => $value pairs to use. Default

src/wp-includes/widgets/class-wp-widget-categories.php

@@ -41,10 +41,10 @@ public function __construct() {
 	 * @param array $args {
 	 *     Display arguments.
 	 *
-	 *     @type string $before_widget HTML markup to prepend to each widget in the sidebar.
-	 *     @type string $after_widget  HTML markup to append to each widget in the sidebar.
-	 *     @type string $before_title  HTML markup to prepend to the widget title when displayed.
-	 *     @type string $after_title   HTML markup to append to the widget title when displayed.
+	 *     @type string $before_widget Required. HTML markup to prepend to each widget in the sidebar.
+	 *     @type string $after_widget  Required. HTML markup to append to each widget in the sidebar.
+	 *     @type string $before_title  Required. HTML markup to prepend to the widget title when displayed.
+	 *     @type string $after_title   Required. HTML markup to append to the widget title when displayed.
 	 * }
 	 * @param array $instance {
 	 *     Settings for the current Categories widget instance.