Twenty Twenty-One: Use third-person singular verbs for function descriptions.

Reference: [https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/#documenting-tips PHP Documentation Standards: Documenting Tips].

Props vladimiraus, mukesh27, SergeyBiryukov.
See #63692.

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

Author: SergeyBiryukov

src/wp-content/themes/twentytwentyone/assets/js/customize-helpers.js

@@ -1,5 +1,5 @@
 /**
- * Get luminance from a HEX color.
+ * Gets luminance from a HEX color.
  *
  * @since Twenty Twenty-One 1.0
  *
@@ -13,7 +13,7 @@ function twentytwentyoneGetHexLum( hex ) { // jshint ignore:line
 }
 
 /**
- * Get RGB from HEX.
+ * Gets RGB from HEX.
  *
  * @since Twenty Twenty-One 1.0
  *

src/wp-content/themes/twentytwentyone/assets/js/editor-dark-mode-support.js

@@ -6,9 +6,9 @@ if ( document.body.classList.contains( 'twentytwentyone-supports-dark-theme' ) )
 }
 
 /**
- * Once the editor loads, add the dark mode class.
+ * Adds the dark mode class once the editor loads.
  *
- * Wait for the editor to load by periodically checking for an element, then we add the classes.
+ * Waits for the editor to load by periodically checking for an element, then adds the classes.
  *
  * @since Twenty Twenty-One 1.0
  *

src/wp-content/themes/twentytwentyone/assets/js/primary-navigation.js

@@ -5,7 +5,7 @@
  */
 
 /**
- * Toggle an attribute's value
+ * Toggles an attribute's value
  *
  * @since Twenty Twenty-One 1.0
  *
@@ -66,7 +66,7 @@ function twentytwentyoneSubmenuPosition( li ) {
 }
 
 /**
- * Handle clicks on submenu toggles.
+ * Handles clicks on submenu toggles.
  *
  * @since Twenty Twenty-One 1.0
  *
@@ -134,7 +134,7 @@ function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
 		} );
 
 		/**
-		 * Trap keyboard navigation in the menu modal.
+		 * Traps keyboard navigation in the menu modal.
 		 * Adapted from Twenty Twenty.
 		 *
 		 * @since Twenty Twenty-One 1.0
@@ -180,7 +180,7 @@ function twentytwentyoneExpandSubMenu( el ) { // jshint ignore:line
 		} );
 
 		/**
-		 * Close menu and scroll to anchor when an anchor link is clicked.
+		 * Closes menu and scrolls to anchor when an anchor link is clicked.
 		 * Adapted from Twenty Twenty.
 		 *
 		 * @since Twenty Twenty-One 1.1

src/wp-content/themes/twentytwentyone/assets/js/responsive-embeds.js

@@ -5,7 +5,7 @@
  */
 
 /**
- * Add max-width & max-height to <iframe> elements, depending on their width & height props.
+ * Adds max-width & max-height to <iframe> elements, depending on their width & height props.
  *
  * @since Twenty Twenty-One 1.0
  *

src/wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-custom-colors.php

@@ -13,7 +13,7 @@
 class Twenty_Twenty_One_Custom_Colors {
 
 	/**
-	 * Instantiate the object.
+	 * Instantiates the object.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 */
@@ -30,7 +30,7 @@ public function __construct() {
 	}
 
 	/**
-	 * Determine the luminance of the given color and then return #fff or #000 so that the text is always readable.
+	 * Determines the luminance of the given color and then returns #fff or #000 so that the text is always readable.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
@@ -42,9 +42,9 @@ public function custom_get_readable_color( $background_color ) {
 	}
 
 	/**
-	 * Generate color variables.
+	 * Generates color variables.
 	 *
-	 * Adjust the color value of the CSS variables depending on the background color theme mod.
+	 * Adjusts the color value of the CSS variables depending on the background color theme mod.
 	 * Both text and link colors needs to be updated.
 	 * The code below needs to be updated, because the colors are no longer theme mods.
 	 *
@@ -111,7 +111,7 @@ public function editor_custom_color_variables() {
 	}
 
 	/**
-	 * Get luminance from a HEX color.
+	 * Gets luminance from a HEX color.
 	 *
 	 * @static
 	 *

src/wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-customize-color-control.php

@@ -25,7 +25,7 @@ class Twenty_Twenty_One_Customize_Color_Control extends WP_Customize_Color_Contr
 	public $type = 'twenty-twenty-one-color';
 
 	/**
-	 * Colorpicker palette
+	 * Colorpicker palette.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
@@ -34,7 +34,7 @@ class Twenty_Twenty_One_Customize_Color_Control extends WP_Customize_Color_Contr
 	public $palette;
 
 	/**
-	 * Enqueue control related scripts/styles.
+	 * Enqueues control related scripts/styles.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
@@ -54,7 +54,7 @@ public function enqueue() {
 	}
 
 	/**
-	 * Refresh the parameters passed to the JavaScript via JSON.
+	 * Refreshes the parameters passed to the JavaScript via JSON.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *

src/wp-content/themes/twentytwentyone/classes/class-twenty-twenty-one-customize.php

@@ -16,7 +16,7 @@
 	class Twenty_Twenty_One_Customize {
 
 		/**
-		 * Constructor. Instantiate the object.
+		 * Constructor. Instantiates the object.
 		 *
 		 * @since Twenty Twenty-One 1.0
 		 */
@@ -25,7 +25,7 @@ public function __construct() {
 		}
 
 		/**
-		 * Register customizer options.
+		 * Registers customizer options.
 		 *
 		 * @since Twenty Twenty-One 1.0
 		 *
@@ -144,7 +144,7 @@ public function register( $wp_customize ) {
 		}
 
 		/**
-		 * Sanitize boolean for checkbox.
+		 * Sanitizes a boolean for checkbox.
 		 *
 		 * @since Twenty Twenty-One 1.0
 		 *
@@ -156,7 +156,7 @@ public static function sanitize_checkbox( $checked = null ) {
 		}
 
 		/**
-		 * Render the site title for the selective refresh partial.
+		 * Renders the site title for the selective refresh partial.
 		 *
 		 * @since Twenty Twenty-One 1.0
 		 *
@@ -167,7 +167,7 @@ public function partial_blogname() {
 		}
 
 		/**
-		 * Render the site tagline for the selective refresh partial.
+		 * Renders the site tagline for the selective refresh partial.
 		 *
 		 * @since Twenty Twenty-One 1.0
 		 *

src/wp-content/themes/twentytwentyone/image.php

@@ -22,7 +22,7 @@
 			<figure class="wp-block-image">
 				<?php
 				/**
-				 * Filter the default image attachment size.
+				 * Filters the default image attachment size.
 				 *
 				 * @since Twenty Twenty-One 1.0
 				 *

src/wp-content/themes/twentytwentyone/inc/back-compat.php

@@ -12,7 +12,7 @@
  */
 
 /**
- * Display upgrade notice on theme switch.
+ * Displays upgrade notice on theme switch.
  *
  * @since Twenty Twenty-One 1.0
  *

src/wp-content/themes/twentytwentyone/inc/block-patterns.php

@@ -12,7 +12,7 @@
 
 if ( function_exists( 'register_block_pattern_category' ) ) {
 	/**
-	 * Register Block Pattern Category.
+	 * Registers Block Pattern Category.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *
@@ -32,7 +32,7 @@ function twenty_twenty_one_register_block_pattern_category() {
  */
 if ( function_exists( 'register_block_pattern' ) ) {
 	/**
-	 * Register Block Pattern.
+	 * Registers Block Pattern.
 	 *
 	 * @since Twenty Twenty-One 1.0
 	 *