Commit 00ac630001 for wordpress.org
commit 00ac630001df06f4ed3e76c3abcedda352616e8e
Author: westonruter <westonruter@git.wordpress.org>
Date: Sat Oct 17 04:59:52 2026 +0000
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.
Built from https://develop.svn.wordpress.org/trunk@64436
git-svn-id: http://core.svn.wordpress.org/trunk@63586 1a063a9b-81f0-0310-95a4-ce76da25c4cd
diff --git a/wp-content/themes/twentyfifteen/inc/custom-header.php b/wp-content/themes/twentyfifteen/inc/custom-header.php
index 699d72cec7..68ebb0a398 100644
--- a/wp-content/themes/twentyfifteen/inc/custom-header.php
+++ b/wp-content/themes/twentyfifteen/inc/custom-header.php
@@ -146,7 +146,7 @@ if ( ! function_exists( 'twentyfifteen_header_style' ) ) :
/*
* No shorthand so the Customizer can override individual properties.
- * @see https://core.trac.wordpress.org/ticket/31460
+ * @link https://core.trac.wordpress.org/ticket/31460
*/
background-image: url(<?php header_image(); ?>);
background-repeat: no-repeat;
@@ -162,7 +162,7 @@ if ( ! function_exists( 'twentyfifteen_header_style' ) ) :
/*
* No shorthand so the Customizer can override individual properties.
- * @see https://core.trac.wordpress.org/ticket/31460
+ * @link https://core.trac.wordpress.org/ticket/31460
*/
background-image: url(<?php header_image(); ?>);
background-repeat: no-repeat;
diff --git a/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php b/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php
index 8012677ce8..329f7164ee 100644
--- a/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php
+++ b/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php
@@ -22,11 +22,11 @@ if ( ! class_exists( 'TwentyTwenty_Walker_Comment' ) ) {
* @since Twenty Twenty 1.0
*
* @see wp_list_comments()
- * @see https://developer.wordpress.org/reference/functions/get_comment_author_url/
- * @see https://developer.wordpress.org/reference/functions/get_comment_author/
- * @see https://developer.wordpress.org/reference/functions/get_avatar/
- * @see https://developer.wordpress.org/reference/functions/get_comment_reply_link/
- * @see https://developer.wordpress.org/reference/functions/get_edit_comment_link/
+ * @see get_comment_author_url()
+ * @see get_comment_author()
+ * @see get_avatar()
+ * @see get_comment_reply_link()
+ * @see get_edit_comment_link()
*
* @param WP_Comment $comment Comment to display.
* @param int $depth Depth of the current comment.
diff --git a/wp-includes/blocks.php b/wp-includes/blocks.php
index 1701548d8d..626e7b7f14 100644
--- a/wp-includes/blocks.php
+++ b/wp-includes/blocks.php
@@ -2843,7 +2843,7 @@ function build_query_vars_from_query_block( $block, $page ) {
* Logic should be used beforehand to determine if WP_Query should be used in the event that the array
* being passed to post__in is empty.
*
- * @see https://core.trac.wordpress.org/ticket/28099
+ * @link https://core.trac.wordpress.org/ticket/28099
*/
$query['post__in'] = ! empty( $sticky ) ? $sticky : array( 0 );
$query['ignore_sticky_posts'] = 1;
diff --git a/wp-includes/class-wp-http-requests-hooks.php b/wp-includes/class-wp-http-requests-hooks.php
index f399acc860..aac172892f 100644
--- a/wp-includes/class-wp-http-requests-hooks.php
+++ b/wp-includes/class-wp-http-requests-hooks.php
@@ -64,10 +64,10 @@ class WP_HTTP_Requests_Hooks extends WpOrg\Requests\Hooks {
*
* This action maps Requests internal hook to a native WordPress action.
*
- * @see https://github.com/WordPress/Requests/blob/master/docs/hooks.md
- *
* @since 4.7.0
*
+ * @link https://github.com/WordPress/Requests/blob/stable/docs/hooks.md
+ *
* @param array $parameters Parameters from Requests internal hook.
* @param array $request Request data in WP_Http format.
* @param string $url URL to request.
diff --git a/wp-includes/class-wp-script-modules.php b/wp-includes/class-wp-script-modules.php
index 9c9f8a762a..180b42362d 100644
--- a/wp-includes/class-wp-script-modules.php
+++ b/wp-includes/class-wp-script-modules.php
@@ -1102,9 +1102,9 @@ class WP_Script_Modules {
* is not encoded in UTF-8 then it's not safe to include those literals. They must
* be escaped to avoid encoding issues.
*
- * @see https://www.rfc-editor.org/rfc/rfc8259.html for details on encoding requirements.
- * @see https://www.php.net/manual/en/json.constants.php for details on these constants.
- * @see https://html.spec.whatwg.org/#script-data-state for details on script tag parsing.
+ * @link https://www.rfc-editor.org/rfc/rfc8259.html for details on encoding requirements.
+ * @link https://www.php.net/manual/en/json.constants.php for details on these constants.
+ * @link https://html.spec.whatwg.org/#script-data-state for details on script tag parsing.
*/
$json_encode_flags = JSON_HEX_TAG | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_LINE_TERMINATORS;
if ( ! is_utf8_charset() ) {
diff --git a/wp-includes/class-wp-theme-json.php b/wp-includes/class-wp-theme-json.php
index f665f9acd1..f5cdc1b43c 100644
--- a/wp-includes/class-wp-theme-json.php
+++ b/wp-includes/class-wp-theme-json.php
@@ -1583,7 +1583,7 @@ class WP_Theme_JSON {
* there should be no way for a comma to mean anything other than a
* comma token. The exception are syntax errors, which are not handled here.
*
- * @see https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values
+ * @link https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values
*/
if ( strlen( $selector ) === strcspn( $selector, '/\'"(<\\' ) ) {
return preg_replace( '~[ \t\n]*,[ \t\n]*~', "{$to_append}, ", trim( $selector, " \t\n" ) ) . $to_append;
@@ -1632,7 +1632,7 @@ class WP_Theme_JSON {
* there should be no way for a comma to mean anything other than a
* comma token. The exception are syntax errors, which are not handled here.
*
- * @see https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values
+ * @link https://www.w3.org/TR/css-syntax-3/#parse-comma-separated-list-of-component-values
*/
if ( strlen( $selector ) === strcspn( $selector, '/\'"(<\\' ) ) {
return $to_prepend . preg_replace( '~[ \t\n]*,[ \t\n]*~', ", {$to_prepend}", trim( $selector, " \t\n" ) );
@@ -1677,8 +1677,8 @@ class WP_Theme_JSON {
* // Comments stay with the selector they follow.
* array( '.a /* a, the first *\/', '.b' ) === self::split_selector_list( '.a /* a, the first *\/,.b' );
*
- * @see https://www.w3.org/TR/selectors/#parse-selector
- * @see https://www.w3.org/TR/css-syntax-3/
+ * @link https://www.w3.org/TR/selectors/#parse-selector
+ * @link https://www.w3.org/TR/css-syntax-3/
*
* @since 7.1.0
*
@@ -1785,8 +1785,8 @@ class WP_Theme_JSON {
* > not included in this definition, as they are converted
* > to U+000A LINE FEED during preprocessing.
*
- * @see https://www.w3.org/TR/css-syntax/#whitespace
- * @see https://www.w3.org/TR/css-syntax/#newline
+ * @link https://www.w3.org/TR/css-syntax/#whitespace
+ * @link https://www.w3.org/TR/css-syntax/#newline
*/
$selectors[] = trim( substr( $selector, $was_at, $next_at - $was_at ), " \t\n" );
$at = $next_at + 1;
diff --git a/wp-includes/class-wp-url-pattern-prefixer.php b/wp-includes/class-wp-url-pattern-prefixer.php
index a79e6e10c8..3e94db53ff 100644
--- a/wp-includes/class-wp-url-pattern-prefixer.php
+++ b/wp-includes/class-wp-url-pattern-prefixer.php
@@ -124,7 +124,7 @@ class WP_URL_Pattern_Prefixer {
* Escapes a string for use in a URL pattern component.
*
* @since 6.8.0
- * @see https://urlpattern.spec.whatwg.org/#escape-a-pattern-string
+ * @link https://urlpattern.spec.whatwg.org/#escape-a-pattern-string
*
* @param string $str String to be escaped.
* @return string String with backslashes added where required.
diff --git a/wp-includes/class-wpdb.php b/wp-includes/class-wpdb.php
index f961813c3f..9537cdc57c 100644
--- a/wp-includes/class-wpdb.php
+++ b/wp-includes/class-wpdb.php
@@ -1992,7 +1992,7 @@ class wpdb {
/*
* If using the `mysqlnd` library, the IPv6 address needs to be enclosed
* in square brackets, whereas it doesn't while using the `libmysqlclient` library.
- * @see https://bugs.php.net/bug.php?id=67563
+ * @link https://bugs.php.net/bug.php?id=67563
*/
if ( $is_ipv6 && extension_loaded( 'mysqlnd' ) ) {
$host = "[$host]";
diff --git a/wp-includes/compat-utf8.php b/wp-includes/compat-utf8.php
index 5fa8cde158..326786fe60 100644
--- a/wp-includes/compat-utf8.php
+++ b/wp-includes/compat-utf8.php
@@ -120,7 +120,7 @@ function _wp_scan_utf8( string $bytes, int &$at, int &$invalid_length, ?int $max
* │ U+100000..U+10FFFF │ F4 │ 80..8F │ 80..BF │ 80..BF │
* ╰─────────────────────┴────────────┴──────────────┴─────────────┴──────────────╯
*
- * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G27506
+ * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G27506
*/
// Valid two-byte code points.
@@ -197,7 +197,7 @@ function _wp_scan_utf8( string $bytes, int &$at, int &$invalid_length, ?int $max
* > Furthermore, this practice can be defined consistently for better
* > interoperability between different implementations of conversion.
*
- * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630
+ * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630
*/
invalid_utf8:
$at = $i;
diff --git a/wp-includes/compat.php b/wp-includes/compat.php
index bd0c09881a..0aac0481c5 100644
--- a/wp-includes/compat.php
+++ b/wp-includes/compat.php
@@ -18,7 +18,7 @@ if ( ! function_exists( '_' ) ) {
*
* @since 0.71
*
- * @see https://php.net/manual/en/function.gettext.php
+ * @link https://php.net/manual/en/function.gettext.php
*
* @param string $message The message being translated.
* @return string
@@ -459,7 +459,7 @@ if ( ! function_exists( 'array_is_list' ) ) {
*
* An array is considered a list if its keys consist of consecutive numbers from 0 to count($array)-1.
*
- * @see https://github.com/symfony/polyfill-php81/tree/main
+ * @link https://github.com/symfony/polyfill-php81/tree/main
*
* @since 6.5.0
*
diff --git a/wp-includes/customize/class-wp-customize-custom-css-setting.php b/wp-includes/customize/class-wp-customize-custom-css-setting.php
index 58897a7e72..ed825618b2 100644
--- a/wp-includes/customize/class-wp-customize-custom-css-setting.php
+++ b/wp-includes/customize/class-wp-customize-custom-css-setting.php
@@ -201,7 +201,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting {
* that would have broken out of the containing STYLE element, thus
* corrupting the page and potentially introducing security issues.
*
- * @see https://html.spec.whatwg.org/multipage/parsing.html#rawtext-end-tag-name-state
+ * @link https://html.spec.whatwg.org/multipage/parsing.html#rawtext-end-tag-name-state
*/
$possible_style_close_tag = 0 === substr_compare(
$css,
diff --git a/wp-includes/deprecated.php b/wp-includes/deprecated.php
index df621af926..63aa0d3abe 100644
--- a/wp-includes/deprecated.php
+++ b/wp-includes/deprecated.php
@@ -6384,12 +6384,12 @@ function wp_get_global_styles_custom_css() {
* that can use dynamic data (modify the stylesheet depending on some option,
* settings depending on user permissions, etc.).
* See some of the existing hooks to modify theme.json behavior:
- * @see https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/
+ * @link https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/
*
* A different alternative considered was to invalidate the cache upon certain
* events such as options add/update/delete, user meta, etc.
* It was judged not enough, hence this approach.
- * @see https://github.com/WordPress/gutenberg/pull/45372
+ * @link https://github.com/WordPress/gutenberg/pull/45372
*/
$cache_key = 'wp_get_global_styles_custom_css';
$cache_group = 'theme_json';
@@ -6517,9 +6517,9 @@ function wp_add_editor_classic_theme_styles( $editor_settings ) {
* @deprecated 6.9.0 Use wp_enqueue_img_auto_sizes_contain_css_fix() instead.
* @see wp_enqueue_img_auto_sizes_contain_css_fix()
*
- * @see https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size
- * @see https://core.trac.wordpress.org/ticket/62413
- * @see https://core.trac.wordpress.org/ticket/62731
+ * @link https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size
+ * @link https://core.trac.wordpress.org/ticket/62413
+ * @link https://core.trac.wordpress.org/ticket/62731
*/
function wp_print_auto_sizes_contain_css_fix() {
_deprecated_function( __FUNCTION__, '6.9.0', 'wp_enqueue_img_auto_sizes_contain_css_fix' );
diff --git a/wp-includes/formatting.php b/wp-includes/formatting.php
index 58d39a98a7..d261721d70 100644
--- a/wp-includes/formatting.php
+++ b/wp-includes/formatting.php
@@ -2054,9 +2054,9 @@ function sanitize_file_name( $filename ) {
* The “Zs” in the pattern selects characters in the `Space_Separator`
* category, which is what Unicode considers space characters.
*
- * @see https://www.unicode.org/reports/tr44/#General_Category_Values
- * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-6/#G17548
- * @see https://www.php.net/manual/en/regexp.reference.unicode.php
+ * @link https://www.unicode.org/reports/tr44/#General_Category_Values
+ * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-6/#G17548
+ * @link https://www.php.net/manual/en/regexp.reference.unicode.php
*/
$filename = preg_replace( '#\p{Zs}#siu', ' ', $filename );
}
@@ -2655,8 +2655,8 @@ function force_balance_tags( $text ) {
* To get the pattern as a string without the comments paste into a PHP
* REPL like `php -a`.
*
- * @see https://html.spec.whatwg.org/#elements-2
- * @see https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
+ * @link https://html.spec.whatwg.org/#elements-2
+ * @link https://html.spec.whatwg.org/multipage/custom-elements.html#valid-custom-element-name
*
* @example
* ~# php -a
diff --git a/wp-includes/functions.php b/wp-includes/functions.php
index b56f4986fa..3b8f5bd555 100644
--- a/wp-includes/functions.php
+++ b/wp-includes/functions.php
@@ -1077,7 +1077,7 @@ function build_query( $data ) {
* @since 3.2.0
* @access private
*
- * @see https://www.php.net/manual/en/function.http-build-query.php
+ * @link https://www.php.net/manual/en/function.http-build-query.php
*
* @param array|object $data An array or object of data. Converted to array.
* @param string $prefix Optional. Numeric index. If set, start parameter numbering with it.
@@ -2330,8 +2330,8 @@ function wp_is_writable( $path ) {
*
* @since 2.8.0
*
- * @see https://bugs.php.net/bug.php?id=27609
- * @see https://bugs.php.net/bug.php?id=30931
+ * @link https://bugs.php.net/bug.php?id=27609
+ * @link https://bugs.php.net/bug.php?id=30931
*
* @param string $path Windows path to check for write-ability.
* @return bool Whether the path is writable.
@@ -3265,8 +3265,8 @@ function wp_check_filetype_and_ext( $file, $filename, $mimes = null ) {
* finfo_file() can return duplicate mime type for Google docs,
* this conditional reduces it to a single instance.
*
- * @see https://bugs.php.net/bug.php?id=77784
- * @see https://core.trac.wordpress.org/ticket/57898
+ * @link https://bugs.php.net/bug.php?id=77784
+ * @link https://core.trac.wordpress.org/ticket/57898
*/
if ( 2 === substr_count( $real_mime, $google_docs_type ) ) {
$real_mime = $google_docs_type;
@@ -7047,7 +7047,7 @@ function wp_timezone_choice( $selected_zone, $locale = null ) {
* @since 2.8.0
* @access private
*
- * @see https://core.trac.wordpress.org/ticket/8497
+ * @link https://core.trac.wordpress.org/ticket/8497
*
* @param string $str Header comment to clean up.
* @return string Cleaned header comment.
@@ -7257,8 +7257,8 @@ function __return_empty_string() { // phpcs:ignore WordPress.NamingConventions.V
*
* @since 3.0.0
*
- * @see https://blogs.msdn.com/ie/archive/2008/07/02/ie8-security-part-v-comprehensive-protection.aspx
- * @see https://src.chromium.org/viewvc/chrome?view=rev&revision=6985
+ * @link https://learn.microsoft.com/en-us/archive/blogs/ie/ie8-security-part-v-comprehensive-protection
+ * @link https://fetch.spec.whatwg.org/#x-content-type-options-header
*/
function send_nosniff_header() {
header( 'X-Content-Type-Options: nosniff' );
@@ -7375,8 +7375,8 @@ function wp_find_hierarchy_loop_tortoise_hare( $callback, $start, $override = ar
*
* @since 3.1.3
*
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Frame-Options
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/frame-ancestors
+ * @link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Frame-Options
+ * @link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy/frame-ancestors
*/
function send_frame_options_header() {
if ( ! headers_sent() ) {
@@ -7454,7 +7454,7 @@ function wp_allowed_protocols() {
*
* @since 3.4.0
*
- * @see https://core.trac.wordpress.org/ticket/19589
+ * @link https://core.trac.wordpress.org/ticket/19589
*
* @param string $ignore_class Optional. A class to ignore all function calls within - useful
* when you want to just give info about the callee. Default null.
@@ -7827,7 +7827,7 @@ function is_utf8_charset( $blog_charset = null ) {
* @since 3.6.0
* @access private
*
- * @see https://core.trac.wordpress.org/ticket/23688
+ * @link https://core.trac.wordpress.org/ticket/23688
*
* @param string $charset A charset name, e.g. "UTF-8", "Windows-1252", "SJIS".
* @return string The canonical form of the charset.
diff --git a/wp-includes/global-styles-and-settings.php b/wp-includes/global-styles-and-settings.php
index 8c9affa79a..efa1c08d07 100644
--- a/wp-includes/global-styles-and-settings.php
+++ b/wp-includes/global-styles-and-settings.php
@@ -144,12 +144,12 @@ function wp_get_global_stylesheet( $types = array() ) {
* that can use dynamic data (modify the stylesheet depending on some option,
* settings depending on user permissions, etc.).
* See some of the existing hooks to modify theme.json behavior:
- * @see https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/
+ * @link https://make.wordpress.org/core/2022/10/10/filters-for-theme-json-data/
*
* A different alternative considered was to invalidate the cache upon certain
* events such as options add/update/delete, user meta, etc.
* It was judged not enough, hence this approach.
- * @see https://github.com/WordPress/gutenberg/pull/45372
+ * @link https://github.com/WordPress/gutenberg/pull/45372
*/
$cache_group = 'theme_json';
$cache_key = 'wp_get_global_stylesheet';
diff --git a/wp-includes/js/codemirror/fakejshint.js b/wp-includes/js/codemirror/fakejshint.js
index b3290c4406..c064d4d505 100644
--- a/wp-includes/js/codemirror/fakejshint.js
+++ b/wp-includes/js/codemirror/fakejshint.js
@@ -6,8 +6,8 @@
* @since 4.9.3
* @deprecated 7.0.0
* @output wp-includes/js/codemirror/fakejshint.js
- * @see https://core.trac.wordpress.org/ticket/42850
- * @see https://core.trac.wordpress.org/ticket/64558
+ * @link https://core.trac.wordpress.org/ticket/42850
+ * @link https://core.trac.wordpress.org/ticket/64558
*/
/* jshint -W057, -W058 */
diff --git a/wp-includes/kses.php b/wp-includes/kses.php
index aba6e0d2a5..cbe2f4d04c 100644
--- a/wp-includes/kses.php
+++ b/wp-includes/kses.php
@@ -2489,7 +2489,7 @@ function wp_kses_split2( $content, $allowed_html, $allowed_protocols ) {
*
* Preserve these comments and do not treat them like tags.
*
- * @see https://html.spec.whatwg.org/#bogus-comment-state
+ * @link https://html.spec.whatwg.org/#bogus-comment-state
*/
if ( 1 === preg_match( '~^(?:</[^a-zA-Z][^>]*>|<![a-z][^>]*>)$~', $content ) ) {
/**
@@ -3389,7 +3389,7 @@ function wp_kses_normalize_entities3( $matches ) {
*
* @since 2.7.0
*
- * @see https://www.w3.org/TR/xml/#charsets
+ * @link https://www.w3.org/TR/xml/#charsets
*
* @param int $i Unicode codepoint.
* @return bool Whether or not the codepoint is a valid Unicode codepoint.
diff --git a/wp-includes/media.php b/wp-includes/media.php
index 2ffa92f2ed..3bb7045611 100644
--- a/wp-includes/media.php
+++ b/wp-includes/media.php
@@ -2189,9 +2189,9 @@ function wp_sizes_attribute_includes_valid_auto( string $sizes_attr ): bool {
*
* @since 6.9.0
*
- * @see https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size
- * @see https://core.trac.wordpress.org/ticket/62413
- * @see https://core.trac.wordpress.org/ticket/62731
+ * @link https://html.spec.whatwg.org/multipage/rendering.html#img-contain-size
+ * @link https://core.trac.wordpress.org/ticket/62413
+ * @link https://core.trac.wordpress.org/ticket/62731
*/
function wp_enqueue_img_auto_sizes_contain_css_fix(): void {
// Back-compat for plugins that disable functionality by unhooking this action.
diff --git a/wp-includes/nav-menu-template.php b/wp-includes/nav-menu-template.php
index bad702e35d..c11f00855c 100644
--- a/wp-includes/nav-menu-template.php
+++ b/wp-includes/nav-menu-template.php
@@ -651,7 +651,7 @@ function _nav_menu_item_id_use_once( $id, $item ) {
* WordPress 3.0.0 so this needs to allow for cases in which the filter is
* called without them.
*
- * @see https://core.trac.wordpress.org/ticket/56926
+ * @link https://core.trac.wordpress.org/ticket/56926
*
* @since 6.2.0
*
diff --git a/wp-includes/pluggable.php b/wp-includes/pluggable.php
index d13769cf84..0aaeabbb3b 100644
--- a/wp-includes/pluggable.php
+++ b/wp-includes/pluggable.php
@@ -2392,7 +2392,7 @@ if ( ! function_exists( 'wp_new_user_notification' ) ) :
* end in a period. To avoid the ambiguity, ensure that the login is not the last query
* arg in the URL. If moving it to the end, a trailing period will need to be escaped.
*
- * @see https://core.trac.wordpress.org/tickets/42957
+ * @link https://core.trac.wordpress.org/ticket/42957
*/
$message .= network_site_url( 'wp-login.php?login=' . rawurlencode( $user->user_login ) . "&key=$key&action=rp", 'login' ) . "\r\n";
diff --git a/wp-includes/script-loader.php b/wp-includes/script-loader.php
index cd1d53a5fb..dfaaf73ede 100644
--- a/wp-includes/script-loader.php
+++ b/wp-includes/script-loader.php
@@ -178,7 +178,7 @@ function wp_default_packages_vendor( $scripts ) {
* These scripts enable hot module replacement (HMR) for block development
* when using `wp-scripts start --hot`.
*
- * @see https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts#start
+ * @link https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts#start
*
* @since 6.0.0
*
@@ -3051,7 +3051,7 @@ function wp_prefetch_admin_assets(): void {
/**
* Prefetches the page's rel=prefetch links with fetch() in browsers that do not support rel=prefetch.
*
- * @see https://caniuse.com/link-rel-prefetch
+ * @link https://caniuse.com/link-rel-prefetch
*/
() => {
if ( document.createElement( 'link' ).relList?.supports?.( 'prefetch' ) ) {
@@ -4657,8 +4657,8 @@ function wp_hoist_late_printed_styles(): void {
*
* @since 6.9.0
*
- * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs
* @see \wp_html_custom_data_attribute_name()
+ * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs
*
* @param string $html_attribute_name Raw attribute name as found in the source HTML.
* @return string|null Transformed `dataset` name, if interpretable as a custom data attribute, else `null`.
@@ -4684,7 +4684,7 @@ function wp_js_dataset_name( string $html_attribute_name ): ?string {
* > U+002D HYPHEN-MINUS character (-) and replace the character that
* > followed it by the same character converted to ASCII uppercase.
*
- * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs
+ * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs
*/
$custom_name = '';
$at = 5;
@@ -4735,8 +4735,8 @@ function wp_js_dataset_name( string $html_attribute_name ): ?string {
*
* @since 6.9.0
*
- * @see https://html.spec.whatwg.org/#concept-domstringmap-pairs
* @see \wp_js_dataset_name()
+ * @link https://html.spec.whatwg.org/#concept-domstringmap-pairs
*
* @param string $js_dataset_name Name of JS `dataset` property to transform.
* @return string|null Corresponding name of an HTML custom data attribute for the given dataset name,
diff --git a/wp-includes/speculative-loading.php b/wp-includes/speculative-loading.php
index dd33cc5395..bb20f805a7 100644
--- a/wp-includes/speculative-loading.php
+++ b/wp-includes/speculative-loading.php
@@ -51,7 +51,7 @@ function wp_get_speculation_rules_configuration(): ?array {
* indicating that speculative loading is entirely disabled.
*
* @since 6.8.0
- * @see https://developer.chrome.com/docs/web-platform/prerender-pages
+ * @link https://developer.chrome.com/docs/web-platform/prerender-pages
*
* @param array<string, string>|null $config Associative array with 'mode' and 'eagerness' keys, or `null`. The
* default value for both of the keys is 'auto'. Other possible values
diff --git a/wp-includes/style-engine.php b/wp-includes/style-engine.php
index b5c7c96863..835f1c3f1b 100644
--- a/wp-includes/style-engine.php
+++ b/wp-includes/style-engine.php
@@ -32,8 +32,8 @@
*
* @since 6.1.0
*
- * @see https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/#styles
- * @see https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/
+ * @link https://developer.wordpress.org/block-editor/reference-guides/theme-json-reference/theme-json-living/#styles
+ * @link https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/
*
* @param array $block_styles The style object.
* @param array $options {
diff --git a/wp-includes/theme-previews.php b/wp-includes/theme-previews.php
index 287559c984..8b0695cd05 100644
--- a/wp-includes/theme-previews.php
+++ b/wp-includes/theme-previews.php
@@ -61,7 +61,7 @@ function wp_attach_theme_preview_middleware() {
* Sets the JavaScript global WP_BLOCK_THEME_ACTIVATE_NONCE containing the nonce
* required to activate a theme. For use within the site editor.
*
- * @see https://github.com/WordPress/gutenberg/pull/41836
+ * @link https://github.com/WordPress/gutenberg/pull/41836
*
* @since 6.3.0
* @access private
diff --git a/wp-includes/user.php b/wp-includes/user.php
index 30c418ee26..e1030ee025 100644
--- a/wp-includes/user.php
+++ b/wp-includes/user.php
@@ -3421,7 +3421,7 @@ function retrieve_password( $user_login = '' ) {
* end in a period. To avoid the ambiguity, ensure that the login is not the last query
* arg in the URL. If moving it to the end, a trailing period will need to be escaped.
*
- * @see https://core.trac.wordpress.org/tickets/42957
+ * @link https://core.trac.wordpress.org/ticket/42957
*/
$message .= network_site_url( 'wp-login.php?login=' . rawurlencode( $user_login ) . "&key=$key&action=rp", 'login' ) . '&wp_lang=' . $locale . "\r\n\r\n";
diff --git a/wp-includes/utf8.php b/wp-includes/utf8.php
index 6be22a61ff..666d1d4260 100644
--- a/wp-includes/utf8.php
+++ b/wp-includes/utf8.php
@@ -29,7 +29,7 @@ if ( extension_loaded( 'mbstring' ) ) :
* byte sequence required by UTF-8, and that no sequence encodes a UTF-16 surrogate
* code point or any character above the representable range.
*
- * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G32860
+ * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G32860
*
* @since 6.9.0
*
@@ -101,7 +101,7 @@ if (
*
* @since 6.9.0
*
- * @see https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630
+ * @link https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-5/#G40630
*
* @param string $text String which is assumed to be UTF-8 but may contain invalid sequences of bytes.
* @return string Input text with invalid sequences of bytes replaced with the Unicode replacement character.
@@ -146,9 +146,9 @@ endif;
* - U+FFFE–U+FFFF
* - U+1FFFE, U+1FFFF, U+2FFFE, U+2FFFF, …, U+10FFFE, U+10FFFF
*
- * @see https://www.unicode.org/versions/Unicode17.0.0/core-spec/chapter-23/#G12612
- * @see https://www.w3.org/TR/xml/#charsets
- * @see https://html.spec.whatwg.org/#attributes-2
+ * @link https://www.unicode.org/versions/Unicode17.0.0/core-spec/chapter-23/#G12612
+ * @link https://www.w3.org/TR/xml/#charsets
+ * @link https://html.spec.whatwg.org/#attributes-2
*
* @since 6.9.0
*
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 4124058043..500ef70361 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
*
* @global string $wp_version
*/
-$wp_version = '7.2-alpha-64435';
+$wp_version = '7.2-alpha-64436';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
diff --git a/wp-load.php b/wp-load.php
index 40c141f740..684797f8c4 100644
--- a/wp-load.php
+++ b/wp-load.php
@@ -31,7 +31,7 @@ if ( function_exists( 'error_reporting' ) ) {
* Initialize error reporting to a known set of levels.
*
* This will be adapted in wp_debug_mode() located in wp-includes/load.php based on WP_DEBUG.
- * @see https://www.php.net/manual/en/errorfunc.constants.php List of known error levels.
+ * @link https://www.php.net/manual/en/errorfunc.constants.php List of known error levels.
*/
error_reporting( E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_ERROR | E_WARNING | E_PARSE | E_USER_ERROR | E_USER_WARNING | E_RECOVERABLE_ERROR );
}