Changeset 64436

Timestamp:

10/17/2026 04:58:15 AM (4 hours ago)

Author:

westonruter

Message:

Docs: Use @link instead of @see for URL references.

The WordPress inline documentation standards for PHP and JavaScript reserve @see for references to functions, methods, classes, and hooks, and use @link for URLs. While phpDocumentor and JSDoc both accept a URL in @see, core had used both forms for external references such as specifications, Trac tickets, and GitHub pull requests, so the remaining @see tags pointing to URLs are converted to @link across core, the bundled themes, core scripts, and the unit tests.

On the touched lines, @see is kept ahead of @link where both appear, per the standards; links to developer.wordpress.org pages for core functions in Twenty Twenty become @see references to those functions; and links that no longer resolve are updated. The block files synced from Gutenberg, the bundled pomo library, and other third-party code are left unchanged, and the HTML API is handled separately.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10804.
Follow-up to r63569.

Props huzaifaalmesbah, westonruter, noruzzaman, shailu25.
See #65860.

Location:

trunk

Files:

• src/js/_enqueues/deprecated/fakejshint.js (modified) (view diffs)
• src/js/_enqueues/lib/codemirror/javascript-lint.js (modified) (view diffs)
• src/wp-content/themes/twentyfifteen/inc/custom-header.php (modified) (view diffs)
• src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php (modified) (view diffs)
• src/wp-includes/blocks.php (modified) (view diffs)
• src/wp-includes/class-wp-http-requests-hooks.php (modified) (view diffs)
• src/wp-includes/class-wp-script-modules.php (modified) (view diffs)
• src/wp-includes/class-wp-theme-json.php (modified) (view diffs)
• src/wp-includes/class-wp-url-pattern-prefixer.php (modified) (view diffs)
• src/wp-includes/class-wpdb.php (modified) (view diffs)
• src/wp-includes/compat-utf8.php (modified) (view diffs)
• src/wp-includes/compat.php (modified) (view diffs)
• src/wp-includes/customize/class-wp-customize-custom-css-setting.php (modified) (view diffs)
• src/wp-includes/deprecated.php (modified) (view diffs)
• src/wp-includes/formatting.php (modified) (view diffs)
• src/wp-includes/functions.php (modified) (view diffs)
• src/wp-includes/global-styles-and-settings.php (modified) (view diffs)
• src/wp-includes/kses.php (modified) (view diffs)
• src/wp-includes/media.php (modified) (view diffs)
• src/wp-includes/nav-menu-template.php (modified) (view diffs)
• src/wp-includes/pluggable.php (modified) (view diffs)
• src/wp-includes/script-loader.php (modified) (view diffs)
• src/wp-includes/speculative-loading.php (modified) (view diffs)
• src/wp-includes/style-engine.php (modified) (view diffs)
• src/wp-includes/theme-previews.php (modified) (view diffs)
• src/wp-includes/user.php (modified) (view diffs)
• src/wp-includes/utf8.php (modified) (view diffs)
• src/wp-load.php (modified) (view diffs)
• tests/phpunit/tests/actions.php (modified) (view diffs)
• tests/phpunit/tests/auth.php (modified) (view diffs)
• tests/phpunit/tests/blocks/serialize.php (modified) (view diffs)
• tests/phpunit/tests/formatting/balanceTags.php (modified) (view diffs)
• tests/phpunit/tests/pomo/pluralForms.php (modified) (view diffs)
• tests/phpunit/tests/rest-api/wpRestMenuItemsController.php (modified) (view diffs)