Docs: Document the $post global in REST API posts and revisions controllers.

Follow-up to [38832], [40601].

Props viralsampat.
See #60021.

git-svn-id: https://develop.svn.wordpress.org/trunk@57230 602fd350-edb4-49c9-b593-d223f7449a82

Author: SergeyBiryukov

src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

@@ -1742,6 +1742,8 @@ protected function check_delete_permission( $post ) {
 	 * @since 4.7.0
 	 * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
 	 *
+	 * @global WP_Post $post Global post object.
+	 *
 	 * @param WP_Post         $item    Post object.
 	 * @param WP_REST_Request $request Request object.
 	 * @return WP_REST_Response Response object.

src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php

@@ -560,6 +560,8 @@ protected function prepare_items_query( $prepared_args = array(), $request = nul
 	 * @since 4.7.0
 	 * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
 	 *
+	 * @global WP_Post $post Global post object.
+	 *
 	 * @param WP_Post         $item    Post revision object.
 	 * @param WP_REST_Request $request Request object.
 	 * @return WP_REST_Response Response object.