Suggestion commit

Co-authored-by: Weston Ruter <[email protected]>
Co-authored-by: Stephen A. Bernhardt <[email protected]>

Author: 3 people

src/wp-includes/class-wp-theme-json-resolver.php

@@ -681,7 +681,7 @@ public static function get_merged_data( $origin = 'custom' ) {
 	 *
 	 * @since 5.9.0
 	 *
-	 * @return int|null
+	 * @return int|null Custom post type ID.
 	 */
 	public static function get_user_global_styles_post_id() {
 		if ( null !== static::$user_custom_post_type_id ) {
@@ -780,7 +780,7 @@ private static function recursively_iterate_json( $dir ) {
 	 *
 	 * @param array  $variation Theme.json shaped style variation object.
 	 * @param string $scope     Scope to check e.g. theme, block etc.
-	 * @return bool
+	 * @return bool Whether the supplied style variation matches the provided scope.
 	 */
 	private static function style_variation_has_scope( $variation, $scope ) {
 		if ( 'block' === $scope ) {

src/wp-includes/functions.php

@@ -6625,7 +6625,7 @@ function _wp_timezone_choice_usort_callback( $a, $b ) {
  *
  * @param string $selected_zone Selected timezone.
  * @param string $locale        Optional. Locale to load the timezones in. Default current site locale.
- * @return string HTML select element of timezones.
+ * @return string HTML select element for timezones.
  */
 function wp_timezone_choice( $selected_zone, $locale = null ) {
 	static $mo_loaded = false, $locale_loaded = null;
@@ -6827,7 +6827,7 @@ function wp_timezone_choice( $selected_zone, $locale = null ) {
  * @see https://core.trac.wordpress.org/ticket/8497
  *
  * @param string $str Header comment to clean up.
- * @return string Cleaned up header comment.
+ * @return string Cleaned header comment.
  */
 function _cleanup_header_comment( $str ) {
 	return trim( preg_replace( '/\s*(?:\*\/|\?>).*/', '', $str ) );