Changeset 55457

Timestamp:

03/03/2023 02:42:42 PM (20 months ago)

Author:

SergeyBiryukov

Message:

Tests: Second pass at merging file-level and class-level DocBlocks in various unit test files.

Per the​documentation standards, whenever possible, all WordPress files should contain a header DocBlock, regardless of the file’s contents – this includes files containing classes.

However, this recommendation makes less sense for unit test classes if not applied consistently, and the duplicate tags cause some confusion.

This commit aims to reduce confusion and avoid repeating information by combining the DocBlocks.

Follow-up to [55337].

Props sakibmd, fuadragib, robinwpdeveloper, naeemhaque, seakashdiu, jakariaistauk, hasanmisbah, SergeyBiryukov.
Fixes #57723.

Location:

trunk/tests/phpunit/tests

Files:

• block-supports/layout.php (modified) (1 diff)
• block-template-utils.php (modified) (1 diff)
• block-template.php (modified) (1 diff)
• blocks/context.php (modified) (1 diff)
• blocks/editor.php (modified) (1 diff)
• blocks/register.php (modified) (1 diff)
• blocks/render.php (modified) (1 diff)
• blocks/renderCommentTemplate.php (modified) (1 diff)
• blocks/renderReusable.php (modified) (1 diff)
• blocks/serialize.php (modified) (1 diff)
• blocks/supportedStyles.php (modified) (1 diff)
• blocks/wpBlock.php (modified) (1 diff)
• blocks/wpBlockList.php (modified) (1 diff)
• blocks/wpBlockParser.php (modified) (1 diff)
• blocks/wpBlockType.php (modified) (1 diff)
• blocks/wpBlockTypeRegistry.php (modified) (1 diff)
• customize/control.php (modified) (1 diff)
• customize/partial.php (modified) (1 diff)
• customize/selective-refresh-ajax.php (modified) (2 diffs)
• customize/selective-refresh.php (modified) (1 diff)
• feed/wpSimplePieFile.php (modified) (1 diff)
• functions/anonymization.php (modified) (1 diff)
• link/getThePrivacyPolicyLink.php (modified) (1 diff)
• load/wpDebugMode.php (modified) (1 diff)
• rest-api/application-passwords.php (modified) (1 diff)
• rest-api/rest-application-passwords-controller.php (modified) (1 diff)
• rest-api/rest-attachments-controller.php (modified) (1 diff)
• rest-api/rest-autosaves-controller.php (modified) (1 diff)
• rest-api/rest-block-directory-controller.php (modified) (1 diff)
• rest-api/rest-block-renderer-controller.php (modified) (1 diff)
• rest-api/rest-block-type-controller.php (modified) (1 diff)
• rest-api/rest-blocks-controller.php (modified) (1 diff)
• rest-api/rest-categories-controller.php (modified) (1 diff)
• rest-api/rest-comments-controller.php (modified) (1 diff)
• rest-api/rest-controller.php (modified) (1 diff)
• rest-api/rest-global-styles-controller.php (modified) (1 diff)
• rest-api/rest-pages-controller.php (modified) (1 diff)
• rest-api/rest-pattern-directory-controller.php (modified) (1 diff)
• rest-api/rest-plugins-controller.php (modified) (1 diff)
• rest-api/rest-post-meta-fields.php (modified) (1 diff)
• rest-api/rest-post-statuses-controller.php (modified) (1 diff)
• rest-api/rest-post-types-controller.php (modified) (1 diff)
• rest-api/rest-posts-controller.php (modified) (1 diff)
• rest-api/rest-request-validation.php (modified) (1 diff)
• rest-api/rest-request.php (modified) (1 diff)
• rest-api/rest-revisions-controller.php (modified) (1 diff)
• rest-api/rest-schema-sanitization.php (modified) (1 diff)
• rest-api/rest-schema-setup.php (modified) (1 diff)
• rest-api/rest-schema-validation.php (modified) (1 diff)
• rest-api/rest-search-controller.php (modified) (1 diff)
• rest-api/rest-server.php (modified) (1 diff)
• rest-api/rest-settings-controller.php (modified) (1 diff)
• rest-api/rest-sidebars-controller.php (modified) (1 diff)
• rest-api/rest-site-health-controller.php (modified) (1 diff)
• rest-api/rest-tags-controller.php (modified) (1 diff)
• rest-api/rest-taxonomies-controller.php (modified) (1 diff)
• rest-api/rest-term-meta-fields.php (modified) (1 diff)
• rest-api/rest-test-controller.php (modified) (1 diff)
• rest-api/rest-themes-controller.php (modified) (1 diff)
• rest-api/rest-users-controller.php (modified) (1 diff)
• rest-api/rest-widget-types-controller.php (modified) (1 diff)
• rest-api/rest-widgets-controller.php (modified) (1 diff)
• rest-api/wpRestBlockPatternCategoriesController.php (modified) (1 diff)
• rest-api/wpRestBlockPatternsController.php (modified) (1 diff)
• rest-api/wpRestEditSiteExportController.php (modified) (1 diff)
• rest-api/wpRestMenuItemsController.php (modified) (1 diff)
• rest-api/wpRestMenuLocationsController.php (modified) (1 diff)
• rest-api/wpRestMenusController.php (modified) (1 diff)
• rest-api/wpRestTemplatesController.php (modified) (1 diff)
• rest-api/wpRestUrlDetailsController.php (modified) (1 diff)
• robots.php (modified) (1 diff)
• url/getPrivacyPolicyUrl.php (modified) (1 diff)
• user/retrievePassword.php (modified) (1 diff)

trunk/tests/phpunit/tests/block-supports/layout.php

@@ -1 +1 @@
 <?php
 /**
- * Block supports tests for the layout.
+ * Tests for block supports related to layout.
  *
  * @package WordPress
  * @subpackage Block Supports
- * @since 6.0.0
- */
-
-/**
- * Tests for block supports related to layout.
- *
  * @since 6.0.0
  *

trunk/tests/phpunit/tests/block-template-utils.php

@@ -1 +1 @@
 <?php
 /**
- * Tests_Block_Template_Utils class
+ * Tests for the Block Templates abstraction layer.
  *
  * @package WordPress
- */
-
-/**
- * Tests for the Block Templates abstraction layer.
  *
  * @group block-templates

trunk/tests/phpunit/tests/block-template.php

@@ -1 +1 @@
 <?php
 /**
- * Tests_Block_Template class
+ * Tests for the block template loading algorithm.
  *
  * @package WordPress
- */
-
-/**
- * Tests for the block template loading algorithm.
  *
  * @group block-templates

trunk/tests/phpunit/tests/blocks/context.php

@@ -1 +1 @@
 <?php
 /**
- * Block context tests
+ * Tests for block context functions.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.5.0
- */
-
-/**
- * Tests for block context functions.
- *
  * @since 5.5.0
  *

trunk/tests/phpunit/tests/blocks/editor.php

@@ -1 +1 @@
 <?php
 /**
- * Block editor tests
+ * Tests for the block editor methods.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.5.0
- */
-
-/**
- * Tests for the block editor methods.
- *
  * @since 5.5.0
  *

trunk/tests/phpunit/tests/blocks/register.php

@@ -1 +1 @@
 <?php
 /**
- * Block registration tests
+ * Tests for register_block_type(), unregister_block_type(), get_dynamic_block_names(), and register_block_style().
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for register_block_type(), unregister_block_type(), get_dynamic_block_names(), and register_block_style().
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/blocks/render.php

@@ -1 +1 @@
 <?php
 /**
- * Block rendering tests
+ * Tests for block rendering functions.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for block rendering functions.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/blocks/renderCommentTemplate.php

@@ -1 +1 @@
 <?php
 /**
- * Comment Template block rendering tests.
+ * Tests for the Comment Template block rendering.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 6.0.0
- */
-
-/**
- * Tests for the Comment Template block.
- *
  * @since 6.0.0
  *

trunk/tests/phpunit/tests/blocks/renderReusable.php

@@ -1 +1 @@
 <?php
 /**
- * Reusable block rendering tests
+ * Tests for reusable block rendering.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for reusable block rendering.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/blocks/serialize.php

@@ -1 +1 @@
 <?php
 /**
- * Block serialization tests
+ * Tests for block serialization functions.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.3.3
- */
-
-/**
- * Tests for block serialization functions.
  *
  * @since 5.3.3

trunk/tests/phpunit/tests/blocks/supportedStyles.php

@@ -1 +1 @@
 <?php
 /**
- * Block supported style tests
+ * Test block supported styles.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.6.0
- */
-
-/**
- * Test block supported styles.
- *
  * @since 5.6.0
  *

trunk/tests/phpunit/tests/blocks/wpBlock.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Block tests
+ * Tests for WP_Block.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.5.0
- */
-
-/**
- * Tests for WP_Block.
- *
  * @since 5.5.0
  *

trunk/tests/phpunit/tests/blocks/wpBlockList.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Block_List tests
+ * Tests for WP_Block_List.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.5.0
- */
-
-/**
- * Tests for WP_Block_List.
- *
  * @since 5.5.0
  *

trunk/tests/phpunit/tests/blocks/wpBlockParser.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Block_Parser tests
+ * Tests for WP_Block_Parser.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for WP_Block_Parser.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/blocks/wpBlockType.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Block_Type tests
+ * Tests for WP_Block_Type.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for WP_Block_Type.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/blocks/wpBlockTypeRegistry.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Block_Type_Registry tests
+ * Tests for WP_Block_Type_Registry.
  *
  * @package WordPress
  * @subpackage Blocks
- * @since 5.0.0
- */
-
-/**
- * Tests for WP_Block_Type_Registry.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/customize/control.php

@@ -1 +1 @@
 <?php
 /**
- * Test_WP_Customize_Control tests.
+ * Tests for the Test_WP_Customize_Control class.
  *
  * @package WordPress
- */
-
-/**
- * Tests for the Test_WP_Customize_Control class.
  *
  * @todo This is missing dedicated tests for all but one of the methods.

trunk/tests/phpunit/tests/customize/partial.php

@@ -1 +1 @@
 <?php
 /**
- * Test_WP_Customize_Partial tests.
+ * Tests for the Test_WP_Customize_Partial class.
  *
  * @package WordPress
- */
-
-/**
- * Tests for the Test_WP_Customize_Partial class.
  *
  * @group customize

trunk/tests/phpunit/tests/customize/selective-refresh-ajax.php

@@ -1 +1 @@
 <?php
-/**
- * WP_Customize_Selective_Refresh Ajax tests.
- *
- * @package    WordPress
- * @subpackage UnitTests
- */
-
 /**
  * Tests for the WP_Customize_Selective_Refresh class Ajax.
@@ -13 +6 @@
  * is not admin ajax.
  *
- * @since      4.5.0
- * @group      ajax
+ * @package WordPress
+ * @subpackage UnitTests
+ * @since 4.5.0
+ *
+ * @group ajax
  */
 class Test_WP_Customize_Selective_Refresh_Ajax extends WP_UnitTestCase {

trunk/tests/phpunit/tests/customize/selective-refresh.php

@@ -1 +1 @@
 <?php
 /**
- * WP_Customize_Selective_Refresh tests.
+ * Tests for the WP_Customize_Selective_Refresh class.
  *
  * @package WordPress
- */
-
-/**
- * Tests for the WP_Customize_Selective_Refresh class.
  *
  * @group customize

trunk/tests/phpunit/tests/feed/wpSimplePieFile.php

@@ -1 +1 @@
 <?php
 /**
- * Unit tests for methods in `WP_SimplePie_File`.
+ * Tests the `WP_SimplePie_File` class.
  *
  * @package WordPress
  * @subpackage UnitTests
  * @since 5.6.1
- */
-
-/**
- * Tests the `WP_SimplePie_File` class.
  *
  * @group feed
  * @group wp-simplepie-file
- *
- * @since 5.6.1
  */
 class Tests_Feed_wpSimplePieFile extends WP_UnitTestCase {

trunk/tests/phpunit/tests/functions/anonymization.php

@@ -4 +4 @@
  *
  * @package WordPress\UnitTests
- *
- * @since 4.9.6
- */
-
-/**
- * Class Tests_Functions_Anonymization.
  *
  * @since 4.9.6

trunk/tests/phpunit/tests/link/getThePrivacyPolicyLink.php

@@ -1 +1 @@
 <?php
 /**
- * Define a class to test the `get_the_privacy_policy_link()` function.
+ * Test cases for the `get_the_privacy_policy_link()` function.
  *
  * @package WordPress
  * @subpackage UnitTests
  * @since 4.9.6
- */
-
-/**
- * Test cases for the `get_the_privacy_policy_link()` function.
  *
  * @group link
  * @group privacy
  * @covers ::get_the_privacy_policy_link
- *
- * @since 4.9.6
  */
 class Tests_Link_GetThePrivacyPolicyLink extends WP_UnitTestCase {

trunk/tests/phpunit/tests/load/wpDebugMode.php

@@ -7 +7 @@
  * @subpackage UnitTests
  * @since 5.9.0
- */
-
-/**
- * Class Test_WP_Debug_Mode.
  *
  * @group load.php
  * @group wp-debug-mode
  * @covers ::wp_debug_mode
- *
- * @since 5.9.0
  */
 class Test_WP_Debug_Mode extends WP_UnitTestCase {

trunk/tests/phpunit/tests/rest-api/application-passwords.php

@@ -5 +5 @@
  * @package    WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group  restapi
  * @group  app_password

trunk/tests/phpunit/tests/rest-api/rest-application-passwords-controller.php

@@ -5 +5 @@
  * @package    WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-attachments-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-autosaves-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi-autosave
  * @group restapi

trunk/tests/phpunit/tests/rest-api/rest-block-directory-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-block-renderer-controller.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Block_Renderer_Controller tests.
+ * Unit tests covering WP_REST_Block_Renderer_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
- * @since 5.0.0
- */
-
-/**
- * Tests for WP_REST_Block_Renderer_Controller.
- *
  * @since 5.0.0
  *

trunk/tests/phpunit/tests/rest-api/rest-block-type-controller.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Block_Types_Controller tests.
+ * Unit tests covering WP_REST_Block_Types_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
- * @since 5.5.0
- */
-
-/**
- * Tests for WP_REST_Block_Types_Controller.
- *
  * @since 5.5.0
  *

trunk/tests/phpunit/tests/rest-api/rest-blocks-controller.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Blocks_Controller tests
+ * Unit tests covering WP_REST_Blocks_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
  * @since 5.0.0
- */
-
-/**
- * Tests for WP_REST_Blocks_Controller.
  *
- * @since 5.0.0
- *
- * @see WP_Test_REST_Controller_Testcase
+ * @covers WP_REST_Blocks_Controller
  *
  * @group restapi-blocks

trunk/tests/phpunit/tests/rest-api/rest-categories-controller.php

@@ -6 +6 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-comments-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-global-styles-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @covers WP_REST_Global_Styles_Controller
+ *
  * @group restapi-global-styles
  * @group restapi

trunk/tests/phpunit/tests/rest-api/rest-pages-controller.php

@@ -6 +6 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-pattern-directory-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  * @group pattern-directory

trunk/tests/phpunit/tests/rest-api/rest-plugins-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-post-meta-fields.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-post-statuses-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-post-types-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-posts-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-request-validation.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-request.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-revisions-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-schema-sanitization.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-schema-setup.php

@@ -7 +7 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  * @group restapi-jsclient

trunk/tests/phpunit/tests/rest-api/rest-schema-validation.php

@@ -5 +5 @@
  * @package    WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-search-controller.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Search_Controller tests
+ * Unit tests covering WP_REST_Search_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
- */
-
-/**
- * Tests for WP_REST_Search_Controller.
  *
  * @group restapi

trunk/tests/phpunit/tests/rest-api/rest-server.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-settings-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-sidebars-controller.php

@@ -6 +6 @@
  * @subpackage REST_API
  * @since 5.8.0
- */
-
-/**
- * Tests for REST API for Widgets.
+ *
+ * @covers WP_REST_Sidebars_Controller
  *
  * @see WP_Test_REST_Controller_Testcase
  * @group restapi
  * @group widgets
- * @covers WP_REST_Sidebars_Controller
  */
 class WP_Test_REST_Sidebars_Controller extends WP_Test_REST_Controller_Testcase {

trunk/tests/phpunit/tests/rest-api/rest-site-health-controller.php

@@ -5 +5 @@
  * Also generates the fixture data used by the wp-api.js QUnit tests.
  *
- * @package    WordPress
+ * @package WordPress
  * @subpackage REST API
- * @since      5.6.0
- */
-
-/**
+ * @since 5.6.0
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-tags-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-taxonomies-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-term-meta-fields.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-test-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-themes-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi-themes
  * @group restapi

trunk/tests/phpunit/tests/rest-api/rest-users-controller.php

@@ -5 +5 @@
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
+ *
  * @group restapi
  */

trunk/tests/phpunit/tests/rest-api/rest-widget-types-controller.php

@@ -6 +6 @@
  * @subpackage REST_API
  * @since 5.8.0
- */
-
-/**
- * Tests for WP_REST_Widget_Types_Controller.
  *
- * @since 5.8.0
+ * @covers WP_REST_Widget_Types_Controller
  *
  * @see WP_TEST_REST_Controller_Testcase
  * @group restapi
- * @covers WP_REST_Widget_Types_Controller
+ * @group widgets
  */
 class WP_Test_REST_Widget_Types_Controller extends WP_Test_REST_Controller_Testcase {

trunk/tests/phpunit/tests/rest-api/rest-widgets-controller.php

@@ -1 +1 @@
 <?php
 /**
- * Unit tests covering WP_REST_Widgets_Controller_Test functionality.
+ * Unit tests covering WP_REST_Widgets_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
  * @since 5.8.0
- */
-
-/**
- * Tests for REST API for Widgets.
  *
- * @since 5.8.0
+ * @covers WP_REST_Widgets_Controller
  *
  * @see WP_Test_REST_Controller_Testcase
  * @group restapi
- * @covers WP_REST_Widgets_Controller
+ * @group widgets
  */
 class WP_Test_REST_Widgets_Controller extends WP_Test_REST_Controller_Testcase {

trunk/tests/phpunit/tests/rest-api/wpRestBlockPatternCategoriesController.php

@@ -3 +3 @@
  * Unit tests covering WP_Block_Pattern_Categories_Registry functionality.
  *
- * @package    WordPress
+ * @package WordPress
  * @subpackage REST_API
- * @since      6.0.0
- */
-
-/**
- * Tests for REST API for Block Pattern Categories Registry.
- *
  * @since 6.0.0
  *

trunk/tests/phpunit/tests/rest-api/wpRestBlockPatternsController.php

@@ -3 +3 @@
  * Unit tests covering WP_REST_Block_Patterns_Controller functionality.
  *
- * @package    WordPress
+ * @package WordPress
  * @subpackage REST_API
- * @since      6.0.0
- */
-
-/**
- * Tests for REST API for Block Patterns.
- *
  * @since 6.0.0
  *

trunk/tests/phpunit/tests/rest-api/wpRestEditSiteExportController.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Edit_Site_Export_Controller tests.
+ * Unit tests covering WP_REST_Edit_Site_Export_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
- * @since 5.9.0
- */
-
-/**
- * Tests for WP_REST_Edit_Site_Export_Controller.
- *
  * @since 5.9.0
  *

trunk/tests/phpunit/tests/rest-api/wpRestMenuItemsController.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Menu_Items_Controller tests
+ * Unit tests covering WP_REST_Menu_Items_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
  * @since 5.9.0
- */
-
-/**
- * Tests for REST API for Menu items.
  *
  * @group restapi

trunk/tests/phpunit/tests/rest-api/wpRestMenuLocationsController.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Menu_Locations_Controller tests.
+ * Unit tests covering WP_REST_Menu_Locations_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
  * @since 5.9.0
- */
-
-/**
- * Tests for REST API for Menu locations.
  *
  * @group restapi

trunk/tests/phpunit/tests/rest-api/wpRestMenusController.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_Menus_Controller tests
+ * Unit tests covering WP_REST_Menus_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
  * @since 5.9.0
- */
-
-/**
- * Tests for REST API for Menus.
  *
  * @group restapi

trunk/tests/phpunit/tests/rest-api/wpRestTemplatesController.php

@@ -1 +1 @@
 <?php
 /**
- * Unit tests covering the templates endpoint..
+ * Unit tests covering WP_REST_Templates_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST API
- */
-
-/**
- * Tests for REST API for templates.
  *
  * @covers WP_REST_Templates_Controller

trunk/tests/phpunit/tests/rest-api/wpRestUrlDetailsController.php

@@ -1 +1 @@
 <?php
 /**
- * WP_REST_URL_Details_Controller tests.
+ * Unit tests covering WP_REST_URL_Details_Controller functionality.
  *
  * @package WordPress
  * @subpackage REST_API
- * @since 5.9.0
- */
-
-/**
- * Tests for WP_REST_URL_Details_Controller.
- *
  * @since 5.9.0
  *

trunk/tests/phpunit/tests/robots.php

@@ -1 +1 @@
 <?php
 /**
- * Robots functions tests.
+ * Tests for robots template functions and filters.
  *
  * @package WordPress
- */
-
-/**
- * Tests for robots template functions and filters.
  *
  * @group robots

trunk/tests/phpunit/tests/url/getPrivacyPolicyUrl.php

@@ -1 +1 @@
 <?php
 /**
- * Define a class to test `get_privacy_policy_url()`.
+ * Test cases for the `get_privacy_policy_url()` function.
  *
  * @package WordPress
  * @subpackage UnitTests
  * @since 4.9.6
- */
-
-/**
- * Test cases for `get_privacy_policy_url()`.
  *
  * @group url
  * @group privacy
- *
- * @since 4.9.6
  *
  * @covers ::get_privacy_policy_url

trunk/tests/phpunit/tests/user/retrievePassword.php

@@ -4 +4 @@
  *
  * @package WordPress
- * @since 6.0.0
- */
-
-/**
- * Test retrieve_password(), in wp-includes/user.php.
- *
  * @since 6.0.0
  *