From eb394751bb3dbd66f079a608840ee860f2aeb994 Mon Sep 17 00:00:00 2001
From: Richard Korthuis <73702842+richardkorthuis@users.noreply.github.com>
Date: Wed, 12 Feb 2025 09:03:28 +0100
Subject: [PATCH] Add documentation for
 WordPress.NamingConventions.ValidVariableName (#2457)

* Add documentation for WordPress.NamingConventions.ValidVariableName

---------

Co-authored-by: Juliette <663378+jrfnl@users.noreply.github.com>
---
 .../ValidVariableNameStandard.xml             | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 WordPress/Docs/NamingConventions/ValidVariableNameStandard.xml

diff --git a/WordPress/Docs/NamingConventions/ValidVariableNameStandard.xml b/WordPress/Docs/NamingConventions/ValidVariableNameStandard.xml
new file mode 100644
index 000000000..56d400cfb
--- /dev/null
+++ b/WordPress/Docs/NamingConventions/ValidVariableNameStandard.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Valid Variable Name"
+>
+    <standard>
+    <![CDATA[
+    Use lowercase letters in variable names. Separate words using underscores.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Lowercase variable name.">
+        <![CDATA[
+<em>$prefix_variable_name</em> = 'value';
+
+echo <em>$prefix_variable_name</em>;
+        ]]>
+        </code>
+        <code title="Invalid: Mixed case function name.">
+        <![CDATA[
+<em>$Prefix_Variable_NAME</em> = 'value';
+
+echo <em>$Prefix_Variable_NAME</em>;
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Words separated by underscores.">
+        <![CDATA[
+class My_Class {
+    public <em>$property_name</em> = 'value';
+}
+        ]]>
+        </code>
+        <code title="Invalid: Using camel case to separate words.">
+        <![CDATA[
+class My_Class {
+    public <em>$propertyName</em> = 'value';
+}
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>