Docs: Improve inline comments per the documentation standards.

Includes minor code layout fixes for better readability.

See #48303.

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

tests/phpunit/tests/comment/query.php

@@ -1,6 +1,6 @@
 <?php
 
-// Test the output of Comment Querying functions
+// Test the output of Comment Querying functions.
 
 /**
  * @group comment
@@ -1415,8 +1415,8 @@ class Tests_Comment_Query extends WP_UnitTestCase {
 		);
 		$this->assertEquals( array( $comment_id3, $comment_id ), wp_list_pluck( $comments, 'comment_ID' ) );
 
-		// value1 is present on two different keys for $comment_id yet we should get only one instance
-		// of that comment in the results
+		// 'value1' is present on two different keys for $comment_id,
+		// yet we should get only one instance of that comment in the results.
 		$comments = get_comments(
 			array(
 				'meta_value' => 'value1',