Skip to content

Docs: Remove the blank line between @param and @return in test docblocks - #80

Closed
mukeshpanchal27 wants to merge 2 commits into
trunkfrom
docs/param-return-blank-line-tests
Closed

Docs: Remove the blank line between @param and @return in test docblocks#80
mukeshpanchal27 wants to merge 2 commits into
trunkfrom
docs/param-return-blank-line-tests

Conversation

@mukeshpanchal27

Copy link
Copy Markdown
Owner

Summary

Follow-up to the same correction made in src/wp-includes, kept as a separate PR so each diff stays focused.

The PHP inline documentation standards place @return immediately after the last @param tag, with no blank line between them:

/**
 * Summary.
 *
 * @param string $var Description.
 * @return string Description.
 */

This corrects 65 docblocks across 29 files in the PHPUnit test suite.

Where the changes land

Area Occurrences
tests/phpunit/includes/factory/ 30
tests/phpunit/tests/ajax/ (privacy export/erase, crop image) 15
tests/phpunit/tests/customize/ 6
tests/phpunit/tests/rest-api/ 3
Remaining (block-supports, blocks, html-api, kses, image, post, privacy, term, functions) 11

Verification

  • Diff audit: every changed line is a removed * blank comment line — no other content touched. 29 files changed, 0 insertions, 65 deletions.
  • Re-scan of tests/: 0 remaining occurrences.
  • php -l clean on all 29 changed files.

Documentation-only; no test logic or assertions changed.

Related

Branched directly from trunk, so it is independent of #79 (the src/wp-includes counterpart) and the two can land in either order.

🤖 Generated with Claude Code

mukeshpanchal27 and others added 2 commits August 16, 2026 12:14
…cblocks.

The PHP inline documentation standards place `@return` immediately after the
last `@param` tag, with no blank line separating them. This corrects 65
docblocks across 29 files in the PHPUnit test suite that used a line break
between the two tags.

This is a follow-up to the same correction made in `src/wp-includes`, kept as a
separate change to keep each diff focused.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mukeshpanchal27

Copy link
Copy Markdown
Owner Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant