diff --git a/docs/getting-started.md b/docs/getting-started.md index e9a3d22..158a633 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -110,12 +110,7 @@ function my_plugin_register_abilities() { wp_register_ability( 'my-plugin/get-site-title', array( 'label' => __( 'Get Site Title', 'my-plugin' ), 'description' => __( 'Retrieves the title of the current WordPress site.', 'my-plugin' ), - 'category' => 'site-info', - 'input_schema' => array( - 'type' => 'object', - 'properties' => array(), - 'additionalProperties' => false, - ), + 'category' => 'site', 'output_schema' => array( 'type' => 'string', 'description' => 'The site title.', diff --git a/docs/php-api.md b/docs/php-api.md index 3e5665f..49d4f15 100644 --- a/docs/php-api.md +++ b/docs/php-api.md @@ -2,7 +2,14 @@ ## Registering Categories -Before registering abilities, you must register at least one category. Categories help organize abilities and make them easier to discover and filter. +Before registering abilities, you need at least one category. Categories help organize abilities and make them easier to discover and filter. + +The Abilities API ships with two default Ability categories: + +- `site`: Abilities that retrieve or modify site information and settings +- `user`: Abilities that retrieve or modify user information and settings. + +Only create new categories if your Ability does not fit one of these two. ### Function Signature