Changeset 47122 for trunk/tests/phpunit/tests/admin/includesListTable.php

Timestamp:

01/29/2020 12:43:23 AM (7 years ago)

Author:

SergeyBiryukov

Message:

Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

File:

• trunk/tests/phpunit/tests/admin/includesListTable.php (modified) (5 diffs)

trunk/tests/phpunit/tests/admin/includesListTable.php

@@ -21 +21 @@
 
         public static function wpSetUpBeforeClass( $factory ) {
-                // note that our top/children/grandchildren arrays are 1-indexed
-
-                // create top level pages
+                // Note that our top/children/grandchildren arrays are 1-indexed.
+
+                // Create top-level pages.
                 $num_posts = 5;
                 foreach ( range( 1, $num_posts ) as $i ) {
@@ -37 +37 @@
                 }
 
-                // create child pages
+                // Create child pages.
                 $num_children = 3;
                 foreach ( self::$top as $top => $top_page ) {
@@ -54 +54 @@
                 }
 
-                // create grand-child pages for the third and fourth top-level pages
+                // Create grand-child pages for the third and fourth top-level pages.
                 $num_grandchildren = 3;
                 foreach ( range( 3, 4 ) as $top ) {
@@ -145 +145 @@
          */
         function test_grandchildren_hierarchical_pages_first_page() {
-                // page 6 is the first page with grandchildren
+                // Page 6 is the first page with grandchildren.
                 $this->_test_list_hierarchical_page(
                         array(
@@ -164 +164 @@
          */
         function test_grandchildren_hierarchical_pages_second_page() {
-                // page 7 is the second page with grandchildren
+                // Page 7 is the second page with grandchildren.
                 $this->_test_list_hierarchical_page(
                         array(