Update copies for the registration of the new abilities - #23598
Update copies for the registration of the new abilities#23598leonidasmi wants to merge 4 commits into
Conversation
Coverage Report for CI Build 3Coverage decreased (-0.09%) to 56.714%Details
Uncovered ChangesNo uncovered changes found. Coverage RegressionsNo coverage regressions found. Coverage Stats💛 - Coveralls |
…etset-data-abilities
…stration-copies-for-the-getset-data-abilities
|
|
||
| return [ | ||
| 'type' => 'object', | ||
| 'properties' => [ |
There was a problem hiding this comment.
Is there a reason we don't keep the title/description format here?
There was a problem hiding this comment.
Yeah that was on purpose.
Output descriptions are not added when the keys are pretty self-explanatory and adding them would add length without adding information. I've seen agents reading both schemas when deciding how to use each ability so not adding self-explanatory stuff probably makes our abilities a bit more friendly to agent token costs.
The same keys have descriptions in the input because it's arguably more important for agents to understand what to send when using the abilities than the final results.
I'd keep as is and we can revisit in the future.
Context
Summary
This PR can be summarized in the following changelog entry:
Relevant technical choices:
Test instructions
Test instructions for the acceptance test before the PR gets merged
This PR can be acceptance tested by following these steps:
/wp-json/wp-abilities/v1/abilitiesRelevant test scenarios
Test instructions for QA when the code is in the RC
Impact check
This PR affects the following parts of the plugin, which may require extra testing:
Other environments
[shopify-seo], added test instructions for Shopify and attached theShopifylabel to this PR.[yoast-doc-extension], added test instructions for Yoast SEO for Google Docs and attached theGoogle Docs Add-onlabel to this PR.Documentation
Quality assurance
grunt build:imagesand committed the results, if my PR introduces or edits images or SVGs.Innovation
innovationlabel.Fixes #