From cc01a7923d17d4a5cee0b695a257bd17b42a9282 Mon Sep 17 00:00:00 2001
From: Brian Dunne <braindawg@gmail.com>
Date: Sat, 22 Feb 2025 22:58:20 -0600
Subject: [PATCH 1/3] Add XML doc for Squiz\Classes\ClassFileName sniff

---
 .../Docs/Classes/ClassFileNameStandard.xml    | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml

diff --git a/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
new file mode 100644
index 0000000000..046ce20451
--- /dev/null
+++ b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
@@ -0,0 +1,47 @@
+<documentation title="Class File Name">
+    <standard>
+    <![CDATA[
+    The file name and the name of the class defined within the file must match exactly, including case.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Defined class name and filename match.">
+        <![CDATA[
+        <em>/* ./src/Foo.php contents: */</em>
+
+class Foo
+{
+}
+        ]]>
+        </code>
+        <code title="Invalid: Class name does not match filename.">
+        <![CDATA[
+        <em>/* ./src/Foo.php contents: */</em>
+
+class MyFoo
+{
+}
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Class name and filename use the same casing.">
+        <![CDATA[
+        <em>/* ./src/MyFoo.php contents: */</em>
+
+class MyFoo
+{
+}
+        ]]>
+        </code>
+        <code title="Invalid: Class name case does not match filename case.">
+        <![CDATA[
+        <em>/* ./src/myFoo.php contents: */</em>
+
+class MyFoo
+{
+}
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From 1e8f5db58c9b4f304fd4050c80d82eed1fa602a8 Mon Sep 17 00:00:00 2001
From: Brian Dunne <braindawg@gmail.com>
Date: Mon, 24 Feb 2025 20:19:07 -0600
Subject: [PATCH 2/3] [Doc] Emphasize sniff focus for ClassFileName

Adjusts the `<em>` tags in the Squiz.Classes.ClassFileName sniff XML
docs to better highlight the parts of the code samples that illustrate
the purpose of the sniff.
---
 .../Squiz/Docs/Classes/ClassFileNameStandard.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
index 046ce20451..945513e809 100644
--- a/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
+++ b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
@@ -7,18 +7,18 @@
     <code_comparison>
         <code title="Valid: Defined class name and filename match.">
         <![CDATA[
-        <em>/* ./src/Foo.php contents: */</em>
+        /* ./src/<em>Foo.php</em> contents: */
 
-class Foo
+class <em>Foo</em>
 {
 }
         ]]>
         </code>
         <code title="Invalid: Class name does not match filename.">
         <![CDATA[
-        <em>/* ./src/Foo.php contents: */</em>
+        /* ./src/<em>Foo.php</em> contents: */
 
-class MyFoo
+class <em>MyFoo</em>
 {
 }
         ]]>
@@ -27,18 +27,18 @@ class MyFoo
     <code_comparison>
         <code title="Valid: Class name and filename use the same casing.">
         <![CDATA[
-        <em>/* ./src/MyFoo.php contents: */</em>
+        /* ./src/<em>MyFoo.php</em> contents: */
 
-class MyFoo
+class <em>MyFoo</em>
 {
 }
         ]]>
         </code>
         <code title="Invalid: Class name case does not match filename case.">
         <![CDATA[
-        <em>/* ./src/myFoo.php contents: */</em>
+        /* ./src/<em>myFoo.php</em> contents: */
 
-class MyFoo
+class <em>MyFoo</em>
 {
 }
         ]]>

From f75039a425331ea1e63f19020167e48c6aff8610 Mon Sep 17 00:00:00 2001
From: Brian Dunne <braindawg@gmail.com>
Date: Fri, 7 Mar 2025 10:57:00 -0600
Subject: [PATCH 3/3] Correct file/class name relation in sniff doc

Per PR #845, the filename must be modified to match the class name,
since class names are much more restrictive than filenames and the
inverse is not always possible.

This clarifies in the example titles that the fix for the invalid code
is to modify the filename rather than the class name.
---
 src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
index 945513e809..b252969238 100644
--- a/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
+++ b/src/Standards/Squiz/Docs/Classes/ClassFileNameStandard.xml
@@ -14,7 +14,7 @@ class <em>Foo</em>
 }
         ]]>
         </code>
-        <code title="Invalid: Class name does not match filename.">
+        <code title="Invalid: Filename does not match class name.">
         <![CDATA[
         /* ./src/<em>Foo.php</em> contents: */
 
@@ -34,7 +34,7 @@ class <em>MyFoo</em>
 }
         ]]>
         </code>
-        <code title="Invalid: Class name case does not match filename case.">
+        <code title="Invalid: Filename case does not match class name case.">
         <![CDATA[
         /* ./src/<em>myFoo.php</em> contents: */