Merge pull request #1328 from Shelob9/patch-6

Improve @return inline docs for rest_ensure_response()

plugin.php

@@ -502,8 +502,7 @@ function rest_ensure_request( $request ) {
  * immediately check for this value.
  *
  * @param WP_Error|WP_HTTP_ResponseInterface|mixed $response Response to check.
- * @return mixed WP_Error if present, WP_HTTP_ResponseInterface if instance,
- *               otherwise WP_REST_Response.
+ * @return WP_Error|WP_HTTP_ResponseInterface|WP_REST_Response WP_Error if response generated an error, WP_HTTP_ResponseInterface if response is a already an instance, otherwise returns a new WP_REST_Response instance.
  */
 function rest_ensure_response( $response ) {
 	if ( is_wp_error( $response ) ) {