From 916b5f8c13d8264665cfda7f61ab20ab19455fd9 Mon Sep 17 00:00:00 2001
From: Brian Dunne <braindawg@gmail.com>
Date: Sat, 1 Mar 2025 20:44:45 -0600
Subject: [PATCH] Clarify PascalCase class naming requirement

Added a friendlier description of the PascalCase requirements.

Adds an extra example to clarify that it's not just a leading capital
we're looking for - we also need only letters and numbers.
---
 .../Docs/Classes/ValidClassNameStandard.xml   | 22 ++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/src/Standards/Squiz/Docs/Classes/ValidClassNameStandard.xml b/src/Standards/Squiz/Docs/Classes/ValidClassNameStandard.xml
index ecf9c0d344..cc1a4e9d7c 100644
--- a/src/Standards/Squiz/Docs/Classes/ValidClassNameStandard.xml
+++ b/src/Standards/Squiz/Docs/Classes/ValidClassNameStandard.xml
@@ -1,11 +1,11 @@
 <documentation title="Valid Class Name">
     <standard>
     <![CDATA[
-    Class names must be written in Pascal case.
+    Class names must be written in Pascal case. This means that it starts with a capital letter, and the first letter of each word in the class name is capitalized. Only letters and numbers are allowed.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: Class name is written in Pascal case.">
+        <code title="Valid: Class name starts with a capital letter.">
         <![CDATA[
 class <em>PascalCaseStandard</em>
 {
@@ -19,5 +19,21 @@ class <em>notPascalCaseStandard</em>
 }
         ]]>
         </code>
-        </code_comparison>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Class name contains only letters and numbers.">
+        <![CDATA[
+class <em>PSR7Response</em>
+{
+}
+        ]]>
+        </code>
+        <code title="Invalid: Class name contains underscores.">
+        <![CDATA[
+class <em>PSR7_Response</em>
+{
+}
+        ]]>
+        </code>
+    </code_comparison>
 </documentation>