From a6e6fa2675570106665f26e7cff9428575373a5f Mon Sep 17 00:00:00 2001
From: Rafael Funchal <rafaelfunchal@gmail.com>
Date: Tue, 17 Sep 2024 15:18:04 -0700
Subject: [PATCH 1/2] Adding documentation to WordPress.WP.DiscouragedConstants

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

diff --git a/WordPress/Docs/WP/DiscouragedConstantsStandard.xml b/WordPress/Docs/WP/DiscouragedConstantsStandard.xml
new file mode 100644
index 0000000000..901709cfe7
--- /dev/null
+++ b/WordPress/Docs/WP/DiscouragedConstantsStandard.xml
@@ -0,0 +1,49 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Discouraged Constants"
+    >
+    <standard>
+    <![CDATA[
+    The usage of WordPress Constants is discouraged.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: A function is used in the code to retrieve the theme directory.">
+        <![CDATA[
+<img src="
+<?php echo <em>get_template_directory_uri()</em>; ?>
+/img/logo.svg" />
+        ]]>
+        </code>
+        <code title="Invalid: The TEMPLATEPATH constant is used in the code.">
+        <![CDATA[
+<img src="
+<?php echo <em>TEMPLATEPATH</em>;?>
+/img/logo.svg" />
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Defining WordPress Constants is discouraged.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: A function is used in the code to retrieve the theme directory.">
+        <![CDATA[
+<img src="
+<?php echo <em>get_template_directory_uri()</em>; ?>
+/img/logo.svg" />
+        ]]>
+        </code>
+        <code title="Invalid: The TEMPLATEPATH constant is set by a theme.">
+        <![CDATA[
+<em>define("TEMPLATEPATH", "foo");</em>
+<img src="
+<?php echo <em>$foo</em>; ?>
+/img/logo.svg" />
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From eb4b83673ba7690b4293247e15c97a1eb0c1705b Mon Sep 17 00:00:00 2001
From: Paulo Trentin <paulo@paulotrentin.com.br>
Date: Tue, 26 Aug 2025 14:46:44 -0700
Subject: [PATCH 2/2] Add DiscouragedConstants standard doc

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

diff --git a/WordPress/Docs/WP/DiscouragedConstantsStandard.xml b/WordPress/Docs/WP/DiscouragedConstantsStandard.xml
index 901709cfe7..302318040c 100644
--- a/WordPress/Docs/WP/DiscouragedConstantsStandard.xml
+++ b/WordPress/Docs/WP/DiscouragedConstantsStandard.xml
@@ -5,44 +5,35 @@
     >
     <standard>
     <![CDATA[
-    The usage of WordPress Constants is discouraged.
+    The use of certain WordPress constants is discouraged. Examples include `TEMPLATEPATH` and `STYLESHEETPATH`.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: A function is used in the code to retrieve the theme directory.">
+        <code title="Valid: Function used instead of constant.">
         <![CDATA[
-<img src="
-<?php echo <em>get_template_directory_uri()</em>; ?>
-/img/logo.svg" />
+$subdir = <em>get_template_directory()</em> . '/subdir';
         ]]>
         </code>
         <code title="Invalid: The TEMPLATEPATH constant is used in the code.">
         <![CDATA[
-<img src="
-<?php echo <em>TEMPLATEPATH</em>;?>
-/img/logo.svg" />
+$subdir = <em>TEMPLATEPATH</em> . '/subdir';
         ]]>
         </code>
     </code_comparison>
     <standard>
     <![CDATA[
-    Defining WordPress Constants is discouraged.
+    The use of certain WordPress constants is discouraged. Examples include `TEMPLATEPATH` and `STYLESHEETPATH`.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: A function is used in the code to retrieve the theme directory.">
+        <code title="Valid: Function used instead of constant.">
         <![CDATA[
-<img src="
-<?php echo <em>get_template_directory_uri()</em>; ?>
-/img/logo.svg" />
+$dir = <em>get_stylesheet_directory()</em>;
         ]]>
         </code>
-        <code title="Invalid: The TEMPLATEPATH constant is set by a theme.">
+        <code title="Invalid: The STYLESHEETPATH constant is used in the code.">
         <![CDATA[
-<em>define("TEMPLATEPATH", "foo");</em>
-<img src="
-<?php echo <em>$foo</em>; ?>
-/img/logo.svg" />
+$dir = <em>STYLESHEETPATH</em>;
         ]]>
         </code>
     </code_comparison>