Updated Inline Documentation Order

includes/abilities-api/class-wp-abilities-registry.php

@@ -39,10 +39,10 @@ final class WP_Abilities_Registry {
 	 *
 	 * Do not use this method directly. Instead, use the `wp_register_ability()` function.
 	 *
-	 * @see wp_register_ability()
-	 *
 	 * @since 0.1.0
 	 *
+	 * @see wp_register_ability()
+	 *
 	 * @param string              $name       The name of the ability. The name must be a string containing a namespace
 	 *                                        prefix, i.e. `my-plugin/my-ability`. It can only contain lowercase
 	 *                                        alphanumeric characters, dashes and the forward slash.
@@ -175,10 +175,10 @@ public function register( string $name, array $properties = array() ): ?WP_Abili
 	 *
 	 * Do not use this method directly. Instead, use the `wp_unregister_ability()` function.
 	 *
-	 * @see wp_unregister_ability()
-	 *
 	 * @since 0.1.0
 	 *
+	 * @see wp_unregister_ability()
+	 *
 	 * @param string $name The name of the registered ability, with its namespace.
 	 * @return ?\WP_Ability The unregistered ability instance on success, null on failure.
 	 */
@@ -204,10 +204,10 @@ public function unregister( string $name ): ?WP_Ability {
 	 *
 	 * Do not use this method directly. Instead, use the `wp_get_abilities()` function.
 	 *
-	 * @see wp_get_abilities()
-	 *
 	 * @since 0.1.0
 	 *
+	 * @see wp_get_abilities()
+	 *
 	 * @return \WP_Ability[] The array of registered abilities.
 	 */
 	public function get_all_registered(): array {
@@ -231,10 +231,10 @@ public function is_registered( string $name ): bool {
 	 *
 	 * Do not use this method directly. Instead, use the `wp_get_ability()` function.
 	 *
-	 * @see wp_get_ability()
-	 *
 	 * @since 0.1.0
 	 *
+	 * @see wp_get_ability()
+	 *
 	 * @param string $name The name of the registered ability, with its namespace.
 	 * @return ?\WP_Ability The registered ability instance, or null if it is not registered.
 	 */

includes/abilities-api/class-wp-ability.php

@@ -92,10 +92,10 @@ class WP_Ability {
 	 *
 	 * @access private
 	 *
-	 * @see wp_register_ability()
-	 *
 	 * @since 0.1.0
 	 *
+	 * @see wp_register_ability()
+	 *
 	 * @param string              $name       The name of the ability, with its namespace.
 	 * @param array<string,mixed> $properties An associative array of properties for the ability. This should
 	 *                                        include `label`, `description`, `input_schema`, `output_schema`,