From 74adacb801580ef58b8b40d286aa2d129df5c971 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Tue, 9 May 2023 10:35:06 +0000
Subject: [PATCH] Docs: Improve Style Engine file and class headers per the
 documentation standards.

Follow-up to [54156], [55719].

See #57840.

git-svn-id: https://develop.svn.wordpress.org/trunk@55733 602fd350-edb4-49c9-b593-d223f7449a82
---
 .../class-wp-style-engine-css-declarations.php         | 10 ++++------
 .../style-engine/class-wp-style-engine-css-rule.php    |  8 +++-----
 .../class-wp-style-engine-css-rules-store.php          |  8 +++-----
 .../style-engine/class-wp-style-engine-processor.php   |  8 ++------
 src/wp-includes/style-engine/class-wp-style-engine.php |  6 ++----
 5 files changed, 14 insertions(+), 26 deletions(-)

diff --git a/src/wp-includes/style-engine/class-wp-style-engine-css-declarations.php b/src/wp-includes/style-engine/class-wp-style-engine-css-declarations.php
index 7352f10219..c8bbeb0dd6 100644
--- a/src/wp-includes/style-engine/class-wp-style-engine-css-declarations.php
+++ b/src/wp-includes/style-engine/class-wp-style-engine-css-declarations.php
@@ -1,18 +1,16 @@
 <?php
 /**
- * WP_Style_Engine_CSS_Declarations
- *
- * Holds, sanitizes and prints CSS rules declarations
- *
+ * Style Engine: WP_Style_Engine_CSS_Declarations class
+ * 
  * @package WordPress
  * @subpackage StyleEngine
  * @since 6.1.0
  */
 
 /**
- * Class WP_Style_Engine_CSS_Declarations.
+ * Core class used for style engine CSS declarations.
  *
- * Holds, sanitizes, processes and prints CSS declarations for the style engine.
+ * Holds, sanitizes, processes, and prints CSS declarations for the style engine.
  *
  * @since 6.1.0
  */
diff --git a/src/wp-includes/style-engine/class-wp-style-engine-css-rule.php b/src/wp-includes/style-engine/class-wp-style-engine-css-rule.php
index bec1170bb9..a109668cd9 100644
--- a/src/wp-includes/style-engine/class-wp-style-engine-css-rule.php
+++ b/src/wp-includes/style-engine/class-wp-style-engine-css-rule.php
@@ -1,8 +1,6 @@
 <?php
 /**
- * WP_Style_Engine_CSS_Rule
- *
- * An object for CSS rules.
+ * Style Engine: WP_Style_Engine_CSS_Rule class
  *
  * @package WordPress
  * @subpackage StyleEngine
@@ -10,9 +8,9 @@
  */
 
 /**
- * Class WP_Style_Engine_CSS_Rule.
+ * Core class used for style engine CSS rules.
  *
- * Holds, sanitizes, processes and prints CSS declarations for the style engine.
+ * Holds, sanitizes, processes, and prints CSS declarations for the style engine.
  *
  * @since 6.1.0
  */
diff --git a/src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php b/src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php
index d5d6bc0bfe..ee1f229ea8 100644
--- a/src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php
+++ b/src/wp-includes/style-engine/class-wp-style-engine-css-rules-store.php
@@ -1,8 +1,6 @@
 <?php
 /**
- * WP_Style_Engine_CSS_Rules_Store
- *
- * A store for WP_Style_Engine_CSS_Rule objects.
+ * Style Engine: WP_Style_Engine_CSS_Rules_Store class
  *
  * @package WordPress
  * @subpackage StyleEngine
@@ -10,9 +8,9 @@
  */
 
 /**
- * Class WP_Style_Engine_CSS_Rules_Store.
+ * Core class used as a store for WP_Style_Engine_CSS_Rule objects.
  *
- * Holds, sanitizes, processes and prints CSS declarations for the style engine.
+ * Holds, sanitizes, processes, and prints CSS declarations for the style engine.
  *
  * @since 6.1.0
  */
diff --git a/src/wp-includes/style-engine/class-wp-style-engine-processor.php b/src/wp-includes/style-engine/class-wp-style-engine-processor.php
index db86650e2d..693ec18488 100644
--- a/src/wp-includes/style-engine/class-wp-style-engine-processor.php
+++ b/src/wp-includes/style-engine/class-wp-style-engine-processor.php
@@ -1,8 +1,6 @@
 <?php
 /**
- * WP_Style_Engine_Processor
- *
- * Compiles styles from stores or collection of CSS rules.
+ * Style Engine: WP_Style_Engine_Processor class
  *
  * @package WordPress
  * @subpackage StyleEngine
@@ -10,9 +8,7 @@
  */
 
 /**
- * Class WP_Style_Engine_Processor.
- *
- * Compiles styles from stores or collection of CSS rules.
+ * Core class used to compile styles from stores or collection of CSS rules.
  *
  * @since 6.1.0
  */
diff --git a/src/wp-includes/style-engine/class-wp-style-engine.php b/src/wp-includes/style-engine/class-wp-style-engine.php
index 7858ea1e55..393b0bdf28 100644
--- a/src/wp-includes/style-engine/class-wp-style-engine.php
+++ b/src/wp-includes/style-engine/class-wp-style-engine.php
@@ -1,8 +1,6 @@
 <?php
 /**
- * StyleEngine: WP_Style_Engine class
- *
- * This is the main class integrating all other WP_Style_Engine_* classes.
+ * Style Engine: WP_Style_Engine class
  *
  * @package WordPress
  * @subpackage StyleEngine
@@ -10,7 +8,7 @@
  */
 
 /**
- * Class WP_Style_Engine.
+ * The main class integrating all other WP_Style_Engine_* classes.
  *
  * The Style Engine aims to provide a consistent API for rendering styling for blocks across both client-side and server-side applications.
  *