From 650cc45dda24194dfdbb1fc063ec1729ac02714b Mon Sep 17 00:00:00 2001
From: Paulo Trentin <paulo@paulotrentin.com.br>
Date: Tue, 26 Aug 2025 13:58:29 -0700
Subject: [PATCH 1/2] Add GlobalVariableOverride standard doc

---
 .../WP/GlobalVariablesOverrideStandard.xml    | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml

diff --git a/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml b/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml
new file mode 100644
index 0000000000..aeaa7df7d0
--- /dev/null
+++ b/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Global Variables Override"
+    >
+    <standard>
+    <![CDATA[
+    WordPress global variables should not be overridden. This includes variables imported with 
+    the `global` statement within functions, variables assigned via the `$GLOBALS` superglobal array,
+    and variables assigned in the global namespace.
+
+    A few select WordPress global variables like `$content_width` and `$wp_cockneyreplace` are 
+    specifically intended to be overridden by themes/plugins and are exempt from this rule.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Different variable name.">
+        <![CDATA[
+$my_query = new WP_Query( $args );
+        ]]>
+        </code>
+        <code title="Invalid: Global variable overridden.">
+        <![CDATA[
+<em>global $wp_query;</em>
+<em>$wp_query = new WP_Query( $args );</em>
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Custom Superglobal variable.">
+        <![CDATA[
+$GLOBALS['my_data'] = array( 'key' => 'value' );
+        ]]>
+        </code>
+        <code title="Invalid: WordPress Superglobal variable overridden.">
+        <![CDATA[
+<em>$GLOBALS['wp_query'] = new WP_Query( $args );</em>
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From 1c545ee7070d7c3f6f88b4e0365adcda7a3db704 Mon Sep 17 00:00:00 2001
From: Paulo Trentin <paulo@paulotrentin.com.br>
Date: Tue, 26 Aug 2025 15:16:11 -0700
Subject: [PATCH 2/2] Improved doc body following review's suggestions

---
 .../WP/GlobalVariablesOverrideStandard.xml    | 27 +++++++------------
 1 file changed, 9 insertions(+), 18 deletions(-)

diff --git a/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml b/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml
index aeaa7df7d0..e72f42aafc 100644
--- a/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml
+++ b/WordPress/Docs/WP/GlobalVariablesOverrideStandard.xml
@@ -5,36 +5,27 @@
     >
     <standard>
     <![CDATA[
-    WordPress global variables should not be overridden. This includes variables imported with 
-    the `global` statement within functions, variables assigned via the `$GLOBALS` superglobal array,
-    and variables assigned in the global namespace.
+    WordPress global variables should not be overridden.
 
-    A few select WordPress global variables like `$content_width` and `$wp_cockneyreplace` are 
+    Two WordPress global variables, `$content_width` and `$wp_cockneyreplace`, are 
     specifically intended to be overridden by themes/plugins and are exempt from this rule.
     ]]>
     </standard>
     <code_comparison>
         <code title="Valid: Different variable name.">
         <![CDATA[
-$my_query = new WP_Query( $args );
+<em>$my_query</em> = new WP_Query( $args );
+
+
+<em>$GLOBALS['my_data']</em> = "some data";
         ]]>
         </code>
         <code title="Invalid: Global variable overridden.">
         <![CDATA[
 <em>global $wp_query;</em>
-<em>$wp_query = new WP_Query( $args );</em>
-        ]]>
-        </code>
-    </code_comparison>
-    <code_comparison>
-        <code title="Valid: Custom Superglobal variable.">
-        <![CDATA[
-$GLOBALS['my_data'] = array( 'key' => 'value' );
-        ]]>
-        </code>
-        <code title="Invalid: WordPress Superglobal variable overridden.">
-        <![CDATA[
-<em>$GLOBALS['wp_query'] = new WP_Query( $args );</em>
+<em>$wp_query</em> = new WP_Query( $args );
+
+<em>$GLOBALS['wp_query']</em> = new WP_Query( $args );
         ]]>
         </code>
     </code_comparison>