From 2836ece22f75c5f312ae3e0a284b7a42e49fcebc Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Sat, 19 Feb 2022 13:00:04 +0000
Subject: [PATCH] Docs: Improve some DocBlocks in `wp_validate_boolean()` tests
 for consistency.

Follow-up to [46159], [46224], [52775].

See #54725, #54729.

git-svn-id: https://develop.svn.wordpress.org/trunk@52776 602fd350-edb4-49c9-b593-d223f7449a82
---
 .../tests/functions/wpValidateBoolean.php     | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/tests/phpunit/tests/functions/wpValidateBoolean.php b/tests/phpunit/tests/functions/wpValidateBoolean.php
index 2355921bd3..79b9401f4d 100644
--- a/tests/phpunit/tests/functions/wpValidateBoolean.php
+++ b/tests/phpunit/tests/functions/wpValidateBoolean.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Tests the wp_validate_boolean function.
+ * Tests for the wp_validate_boolean() function.
  *
  * @group functions.php
  * @covers ::wp_validate_boolean
@@ -11,24 +11,27 @@ class Tests_Functions_wpValidateBoolean extends WP_UnitTestCase {
 	/**
 	 * Test wp_validate_boolean().
 	 *
-	 * @dataProvider data_provider
-	 *
-	 * @param mixed $test_value
-	 * @param bool $expected
+	 * @dataProvider data_wp_validate_boolean
 	 *
 	 * @ticket 30238
 	 * @ticket 39868
+	 *
+	 * @param mixed $test_value
+	 * @param bool  $expected
 	 */
 	public function test_wp_validate_boolean( $test_value, $expected ) {
 		$this->assertSame( $expected, wp_validate_boolean( $test_value ) );
 	}
 
 	/**
-	 * Provides test scenarios for all possible scenarios in wp_validate_boolean().
+	 * Data provider for test_wp_validate_boolean().
 	 *
-	 * @return array
+	 * @return array[] Test parameters {
+	 *     @type string $test_value Test value.
+	 *     @type string $expected   Expected return value.
+	 * }
 	 */
-	public function data_provider() {
+	public function data_wp_validate_boolean() {
 			$std = new \stdClass();
 
 			return array(