Skip to content

Conversation

@jonathanbossenger
Copy link
Contributor

WIP PR to work on doc updates needed for 6.9 merge proposal

Fixes #110
Fixes #111
Fixes #113

Still need to implement: #111 (comment)

Moved all PHP related docs to the php-api.md
Created new README.md file with correct doc ordering
Removed doc file numbering
Updating main repo README.md doc links
Adding reference for abilities_api_init

Moving hook registration in code examples above callback function for better readability
@codecov
Copy link

codecov bot commented Oct 14, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.59%. Comparing base (e4e3b37) to head (14807ce).
⚠️ Report is 1 commits behind head on trunk.

Additional details and impacted files
@@            Coverage Diff            @@
##              trunk     #117   +/-   ##
=========================================
  Coverage     90.59%   90.59%           
  Complexity      177      177           
=========================================
  Files            20       20           
  Lines          1489     1489           
  Branches        116      117    +1     
=========================================
  Hits           1349     1349           
  Misses          140      140           
Flag Coverage Δ
javascript 94.20% <ø> (ø)
unit 89.57% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@gziolo gziolo added the [Type] Developer Documentation Improvements or additions to documentation label Oct 15, 2025
* Adding ability_class information and example
@jonathanbossenger
Copy link
Contributor Author

Added ability_class example

@jonathanbossenger jonathanbossenger marked this pull request as ready for review October 16, 2025 07:56
@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: jonathanbossenger <psykro@git.wordpress.org>
Co-authored-by: gziolo <gziolo@git.wordpress.org>
Co-authored-by: aaronware <aware@git.wordpress.org>
Co-authored-by: galatanovidiu <ovidiu-galatan@git.wordpress.org>

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

Copy link
Member

@gziolo gziolo left a comment

Choose a reason for hiding this comment

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

Structural changes look great to me.

Thank you also for covering the missing WP filter for Abilities API init.

What has changed for PHP documentation? You consolidated two files. What else should I pay attention to so I don’t have every line again? 😀

@jonathanbossenger
Copy link
Contributor Author

What has changed for PHP documentation? You consolidated two files. What else should I pay attention to so I don’t have every line again? 😀

Major changes were the addition of the category function related documentation, and the inclusion of the ability_class argument with associated example code, which was "pre-reviewed" here.

@jonathanbossenger
Copy link
Contributor Author

Review: #95

Copy link
Member

@gziolo gziolo left a comment

Choose a reason for hiding this comment

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

Included a few clarifications for the latest changes to improve correctness. Let’s include them. Overall this looks great. Thank you for all improvements. Documentation looks pretty good at this stage 👏🎉

@gziolo
Copy link
Member

gziolo commented Oct 17, 2025

I see that recent addition for category handling on the client might require some additional work to land it. Let us know if you need additional pass for review.

@jonathanbossenger jonathanbossenger merged commit e510f3e into trunk Oct 21, 2025
20 checks passed
@jonathanbossenger jonathanbossenger deleted the docs/prepare-6.9 branch October 21, 2025 08:03
@gziolo gziolo changed the title Docs/prepare 6.9 Docs rework in preparation for WP 6.9 Oct 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Developer Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Add abilities_api_init to list of actions WordPress 6.9 doc updates Docs: Improve documentation for category abilities functions

3 participants