Improve the documentation based on the review feedback

Author: gziolo

src/wp-includes/abilities-api.php

@@ -68,7 +68,7 @@
  *     $all_abilities = wp_get_abilities();
  *
  *     // Unregisters when no longer needed.
- *     wp_unregister_ability( 'my-plugin/analyze-text' );
+ *     wp_unregister_ability( 'my-plugin/export-users' );
  *
  * ## Best Practices
  *
@@ -294,7 +294,7 @@ function wp_register_ability( string $name, array $args ): ?WP_Ability {
 /**
  * Unregisters an ability from the Abilities API.
  *
- * Takes a previously registered ability out of the global registry. Use this to
+ * Removes a previously registered ability from the global registry. Use this to
  * disable abilities provided by other plugins or when an ability is no longer needed.
  *
  * Can be called at any time after the ability has been registered.
@@ -483,7 +483,7 @@ function wp_register_ability_category( string $slug, array $args ): ?WP_Ability_
 /**
  * Unregisters an ability category.
  *
- * Takes a previously registered ability category out of the global registry. Use this to
+ * Removes a previously registered ability category from the global registry. Use this to
  * disable ability categories that are no longer needed.
  *
  * Can be called at any time after the ability category has been registered.