Tidy up various docblocks.

Author: peterwilsoncc

inc/namespace.php

@@ -75,7 +75,7 @@ function add_key_rewrite_rule() {
 /**
  * Handle the IndexNow key file request.
  *
- * @param WP $wp WordPress instance.
+ * @param \WP $wp WordPress instance.
  */
 function handle_key_file_request( $wp ) {
 	if ( empty( $wp->query_vars['pwcc_indexnow_key'] ) ) {
@@ -127,23 +127,23 @@ function get_indexnow_key(): string {
  *
  * Runs on the `transition_post_status` action.
  *
- * @param string  $new_status New post status.
- * @param string  $old_status Old post status.
- * @param WP_Post $post       Post object.
+ * @param string   $new_status New post status.
+ * @param string   $old_status Old post status.
+ * @param \WP_Post $post       Post object.
  */
 function maybe_ping_indexnow( $new_status, $old_status, $post ): void {
 	/**
 	 * Filter to preflight the IndexNow ping.
 	 *
 	 * This allow for developers to provide custom logic to determine whether
-	 * to ping IndexNow. Return `true` to ping, `false` to skip, or
+	 * to ping IndexNow. Return `true` to ping, `false` to skip ping, or
 	 * `null` to use the default logic.
 	 *
 	 * @param bool|null $preflight_ping The preflight ping decision.
 	 *                                  Default is `null`, meaning use the default logic.
 	 * @param string    $new_status     The new post status.
 	 * @param string    $old_status     The old post status.
-	 * @param WP_Post   $post           The post object.
+	 * @param \WP_Post  $post           The post object.
 	 */
 	$preflight_ping = apply_filters( 'pwcc/index-now/pre-maybe-ping-indexnow', null, $new_status, $old_status, $post );
 
@@ -152,7 +152,7 @@ function maybe_ping_indexnow( $new_status, $old_status, $post ): void {
 			/**
 			 * Fire the action to ping IndexNow.
 			 *
-			 * @param WP_Post $post The post object.
+			 * @param \WP_Post $post The post object.
 			 */
 			do_action( 'pwcc/index-now/ping', $post );
 		}
@@ -209,7 +209,7 @@ function maybe_ping_indexnow( $new_status, $old_status, $post ): void {
 /**
  * Ping IndexNow with the post URL.
  *
- * @param WP_Post|int $post The post ID or object.
+ * @param \WP_Post|int $post The post ID or object.
  */
 function ping_indexnow( $post ) {
 
@@ -285,7 +285,7 @@ function ping_indexnow( $post ) {
 /**
  * Asynchronous ping to IndexNow.
  *
- * @param mixed $post The post ID or object to ping.
+ * @param \WP_Post|int $post The post ID or object to ping.
  */
 function async_ping_indexnow( $post ) {
 	$post = get_post( $post );