Skip to content

Docs: Fix missing documentation in Themes list table#10963

Closed
noruzzamans wants to merge 20 commits intoWordPress:trunkfrom
noruzzamans:fix-missing-documentation
Closed

Docs: Fix missing documentation in Themes list table#10963
noruzzamans wants to merge 20 commits intoWordPress:trunkfrom
noruzzamans:fix-missing-documentation

Conversation

@noruzzamans
Copy link

Trac Ticket: https://core.trac.wordpress.org/ticket/64224

Why this change?

This change adds missing @global documentation tags.

This aligns the codebase with the WordPress PHP Documentation Standards, ensuring that global variables used within functions are properly documented for better static analysis and code clarity.

@github-actions
Copy link

github-actions bot commented Feb 18, 2026

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.

Core Committers: Use this line as a base for the props when committing in SVN:

Props noruzzaman, westonruter, huzaifaalmesbah.

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

@noruzzamans noruzzamans force-pushed the fix-missing-documentation branch from 29920e8 to 30e4813 Compare February 18, 2026 06:48
@noruzzamans noruzzamans force-pushed the fix-missing-documentation branch from 30e4813 to 2f2d7fd Compare February 18, 2026 06:53
@github-actions
Copy link

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

@noruzzamans noruzzamans force-pushed the fix-missing-documentation branch from 3758c23 to d3615f1 Compare February 20, 2026 04:42
@noruzzamans noruzzamans changed the title Docs: Fix missing documentation in Media and Multisite list tables Docs: Fix missing documentation in Themes list table Feb 20, 2026
Co-authored-by: Huzaifa Al Mesbah <huzaifah4m@gmail.com>
noruzzamans and others added 3 commits February 20, 2026 19:04
Co-authored-by: Huzaifa Al Mesbah <huzaifah4m@gmail.com>
Co-authored-by: Huzaifa Al Mesbah <huzaifah4m@gmail.com>
noruzzamans and others added 2 commits February 23, 2026 04:28
Co-authored-by: Weston Ruter <westonruter@gmail.com>
Co-authored-by: Weston Ruter <westonruter@gmail.com>
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves PHPDoc in WP_MS_Themes_List_Table to better align with WordPress PHP Documentation Standards, primarily by adding missing @global tags and expanding docblocks for clarity/static analysis.

Changes:

  • Add descriptions to existing @global tags (e.g., $status, $page, $totals, $orderby, $order, $s).
  • Add short method summaries and more specific @return annotations for several methods.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

westonruter and others added 4 commits February 22, 2026 20:50
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: gemini-cli <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-cli <176961590+gemini-code-assist[bot]@users.noreply.github.com>
pento pushed a commit that referenced this pull request Feb 23, 2026
Developed in #10963

Props noruzzaman, westonruter, huzaifaalmesbah.
See #64224.


git-svn-id: https://develop.svn.wordpress.org/trunk@61717 602fd350-edb4-49c9-b593-d223f7449a82
@westonruter
Copy link
Member

Committed in r61717 (dc64903)

markjaquith pushed a commit to markjaquith/WordPress that referenced this pull request Feb 23, 2026
Developed in WordPress/wordpress-develop#10963

Props noruzzaman, westonruter, huzaifaalmesbah.
See #64224.

Built from https://develop.svn.wordpress.org/trunk@61717


git-svn-id: http://core.svn.wordpress.org/trunk@61025 1a063a9b-81f0-0310-95a4-ce76da25c4cd
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.

4 participants