Docs: Align @param tag columns in block editor docblocks

[mukeshpanchal27]

Trac ticket: https://core.trac.wordpress.org/ticket/65818

The PHP inline documentation standards call for @param tags in a docblock to line up in columns — types, variable names, and descriptions each starting at the same offset — with wrapped descriptions indented to the description column:

/**
 * Summary.
 *
 * @since x.x.x
 *
 * @param string $var       Description.
 * @param bool   $other_var Description that wraps
 *                          onto a second line.
 */

This corrects 58 @param lines across 16 files in the block editor, block supports, and theme.json classes.

Example

src/wp-admin/widgets-form-blocks.php — before:

 * @param string $message The message being displayed.
 * @param bool   $installed Whether the Classic Widget plugin is installed.

after:

 * @param string $message   The message being displayed.
 * @param bool   $installed Whether the Classic Widget plugin is installed.

Files changed (16)

• src/wp-includes/blocks.php
• src/wp-includes/blocks/accordion.php
• src/wp-includes/blocks/heading.php
• src/wp-includes/blocks/list.php
• src/wp-includes/blocks/navigation-link.php
• src/wp-includes/blocks/navigation.php
• src/wp-includes/blocks/page-list.php
• src/wp-includes/blocks/social-link.php
• src/wp-includes/blocks/widget-group.php
• src/wp-includes/block-supports/layout.php
• src/wp-includes/block-supports/settings.php
• src/wp-includes/block-template-utils.php
• src/wp-includes/class-wp-theme-json.php
• src/wp-includes/class-wp-theme-json-schema.php
• src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php
• src/wp-admin/widgets-form-blocks.php

Part of a series

The original work was a single branch touching 80 files. It is split by component so each can be reviewed and committed independently:

• Docs: Align @param tag columns in block editor docblocks #13311 — block editor (this PR)
• Docs: Align @param tag columns in REST API docblocks #13312 — REST API
• Docs: Align @param tag columns in upgrade, plugin, and theme docblocks #13313 — upgrade, plugins, and themes
• Docs: Align @param tag columns in users and multisite docblocks #13314 — users and multisite
• Docs: Align @param tag columns in post, comment, taxonomy, and media docblocks #13315 — posts, comments, taxonomy, and media
• Docs: Align @param tag columns in administration docblocks #13316 — administration
• Docs: Align @param tag columns in general core API docblocks #13317 — general core APIs

This is a whitespace-only change: git diff -w against trunk is empty, so there is no functional change and no change to any generated documentation output beyond the alignment itself.

Use of AI Tools

AI assistance: Yes
Tool(s): Claude Code
Model(s): Claude Opus 5
Used for: Grouping a single large docblock alignment branch into per-component pull requests, verifying that the split is whitespace-only and that the seven branches together reproduce the original diff line for line, and drafting this description. I reviewed the alignment changes before submitting.

[github-actions]

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Core Committers: Use this line as a base for the props when committing in SVN:

Props mukesh27, wildworks.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

[mukeshpanchal27]

GB changes PR WordPress/gutenberg#81903

[t-hamano]

Thanks for the PR. This PR includes files that are automatically updated by syncing with Gutenberg. The files in src/wp-includes/blocks/ should not be updated.

[t-hamano]

This needs to be fixed, similar to GutenbergPR.

wordpress-develop/src/wp-includes/style-engine/class-wp-style-engine-processor.php

Line 108 in 02778fd

* @param array $options {