Make WordPress Core

Opened 2 weeks ago

Closed 6 days ago

Last modified 5 days ago

#65384 closed defect (bug) (fixed)

Fix duplicate-word and spelling typos in docblocks and comments

Reported by: khokansardar's profile khokansardar Owned by: westonruter's profile westonruter
Milestone: 7.1 Priority: normal
Severity: minor Version:
Component: General Keywords: has-patch has-unit-tests good-first-bug
Focuses: docs Cc:

Description

Several docblocks and inline comments in WordPress core contain duplicated words (the the, in in, on on, is is, from from, and and) and one minor misspelling (Compatability). These do not affect runtime behavior but reduce documentation quality.

This ticket proposes correcting WordPress-owned files only, leaving third-party/bundled libraries (ID3, PHPMailer, SimplePie, plupload, jQuery UI) to be handled upstream.

Affected areas:

  • src/wp-includes/ (fonts.php, comment.php, block-template.php, block-supports/settings.php, rest-api/class-wp-rest-server.php, class-wp-customize-manager.php, class-wp-theme-json-data.php, class-wp-recovery-mode-email-service.php)
  • src/js/_enqueues/ (wp/dashboard.js, wp/widgets/custom-html.js, deprecated/fakejshint.js)
  • tests/phpunit/ (9 comment/docblock fixes)

Attachments (2)

Patch giff.png (23.2 KB) - added by sanayasir 7 days ago.
patch diff.png (128.0 KB) - added by sanayasir 7 days ago.

Download all attachments as: .zip

Change History (15)

This ticket was mentioned in PR #12039 on WordPress/wordpress-develop by @khokansardar.


2 weeks ago
#1

  • Keywords has-unit-tests added

Corrects duplicated words (such as "the the", "in in", "on on", "is is", "from from", "and and") and a misspelling ("Compatability") in WordPress-owned docblocks and inline comments across src/ and the PHPUnit test suite. These are comment-only edits with no functional or behavioral change.

Third-party and bundled libraries (ID3, PHPMailer, SimplePie, plupload, jQuery UI, etc.) are intentionally left untouched, as they are maintained upstream.

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

## Use of AI Tools

N/A

#2 @desrosj
2 weeks ago

  • Keywords good-first-bug added
  • Owner set to khokansardar
  • Status changed from new to assigned
  • Version trunk deleted

Assigning good first bug to mark claimed.

#3 @abdullahramzan
13 days ago

  • Keywords needs-testing added

This ticket was mentioned in Slack in #core by abdullahramzan. View the logs.


13 days ago

@westonruter commented on PR #12039:


9 days ago
#5

## Use of AI Tools
N/A

Is this accurate?

@khokansardar commented on PR #12039:


9 days ago
#6

## Use of AI Tools
N/A

Is this accurate?

Sorry I missed it.

#7 @sanayasir
7 days ago

Tested by reviewing the patch diff on WordPress trunk.

Verified that the duplicated words and the misspelling ("Compatability") have been corrected across the affected WordPress-owned files. Confirmed that the changes are limited to comments and docblocks and do not introduce any functional modifications.

The documentation updates are accurate and the patch looks good.

Patch tests well. ✅

#8 @sabernhardt
7 days ago

  • Keywords needs-testing removed

@sanayasir
7 days ago

@sanayasir
7 days ago

#9 @sanayasir
7 days ago

Please consider the new patch/diff file and ignore the previous one.

#10 @tusharaddweb
6 days ago

Tested patch locally.

All typo and duplicate-word corrections checked across the listed PHP, JavaScript, and test files.

Changes are accurate, properly scoped (third-party libs excluded), and have no runtime impact. Documentation is cleaner now.

#11 @westonruter
6 days ago

  • Owner changed from khokansardar to westonruter
  • Status changed from assigned to reviewing

#12 @westonruter
6 days ago

  • Resolution set to fixed
  • Status changed from reviewing to closed

In 62489:

Docs: Fix duplicate-word and spelling typos in comments and docblocks.

Developed in https://github.com/WordPress/wordpress-develop/pull/12039.

Props khokansardar, sabernhardt, sanayasir, tusharaddweb.
Fixes #65384.

#13 @sabernhardt
5 days ago

  • Milestone changed from Awaiting Review to 7.1
Note: See TracTickets for help on using tickets.