diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php
index e1997e24b8..016ea8c041 100644
--- a/src/wp-includes/post.php
+++ b/src/wp-includes/post.php
@@ -751,7 +751,9 @@ function get_extended( $post ) {
  *
  * @global WP_Post $post Global post object.
  *
- * @param int|WP_Post|null $post   Optional. Post ID or post object. Defaults to global $post.
+ * @param int|WP_Post|null $post   Optional. Post ID or post object. Defaults to global $post. `false` or `0`
+ *                                 returns the current global post inside the loop. A numerically valid post ID
+ *                                 that points to a non-existent post returns `null`.
  * @param string           $output Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
  *                                 correspond to a WP_Post object, an associative array, or a numeric array,
  *                                 respectively. Default OBJECT.
