Skip to content

Conversation

@huzaifaalmesbah
Copy link
Member

Why this change?

To align with the WordPress PHP Inline Documentation Standards, proper tag usage distinguishes between internal code references and external links:

  • When to use @see: accurately references a function, method, class, or variable within the codebase (e.g., @see WP_Query::get_posts()).
  • When to use @link: accurately references a URL, such as external documentation, Trac tickets, GitHub issues, or specifications.

This PR corrects instances in packages/block-library where @see was incorrectly used to point to external URLs.

Description

Replaced incorrect @see tags with @link tags in the following files:

  • packages/block-library/src/comments/index.php
  • packages/block-library/src/gallery/index.php
  • packages/block-library/src/list/index.php
  • packages/block-library/src/loginout/index.php
  • packages/block-library/src/post-navigation-link/index.php
  • packages/block-library/src/query-pagination-numbers/index.php
@github-actions
Copy link

Warning: Type of PR label mismatch

To merge this PR, it requires exactly 1 label indicating the type of PR. Other labels are optional and not being checked here.

  • Required label: Any label starting with [Type].
  • Labels found: .

Read more about Type labels in Gutenberg. Don't worry if you don't have the required permissions to add labels; the PR reviewer should be able to help with the task.

@github-actions
Copy link

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.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: huzaifaalmesbah <huzaifaalmesbah@git.wordpress.org>

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

@github-actions github-actions bot added the [Package] Block library /packages/block-library label Jan 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Package] Block library /packages/block-library

1 participant