From 6d1f6bbae8c1ab6dd1eb3a996a74e7845794487a Mon Sep 17 00:00:00 2001
From: Nic-Sevic <47717887+Nic-Sevic@users.noreply.github.com>
Date: Tue, 17 Sep 2024 14:52:34 -0700
Subject: [PATCH 1/6] Add: documentation for FileName sniff

---
 WordPress/Docs/Files/FileNameStandard.xml | 32 +++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 WordPress/Docs/Files/FileNameStandard.xml

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
new file mode 100644
index 0000000000..6d6f45333a
--- /dev/null
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -0,0 +1,32 @@
+<documentation title="File Name Standards">
+<standard>
+    <![CDATA[
+        Ensures that file names meet the following standards:
+        - Filenames should be all lowercase with hyphens separating words.
+        - Class file names should be based on the class name with "class-" prepended.
+        - Files in `wp-includes` containing template tags should end in `-template`.
+
+        If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: All lowercase with only hyphens as word separators and proper use of prefix/suffix.">
+        <![CDATA[
+echo taxonomy<em>-</em>my<em>-</em>term.inc
+echo <em>s</em>ome<em>f</em>ile.inc
+echo <em>class</em>-testsample.inc
+echo other<em>-</em>punctuation.inc
+echo general<em>-template</em>.php
+        ]]>
+        </code>
+        <code title="Invalid: Use of other punctuation, uppercase, or missing prefix/suffix.">
+        <![CDATA[
+echo taxonomy-my<em>_</em>term.inc.
+echo <em>S</em>ome<em>F</em>ile.inc
+echo <em>testsample</em>-unit-2.inc
+echo other<em>+</em>punctuation<em>#</em>.inc
+echo <em>general</em>.php
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

From 4f4f54135738d4d9caeda87d0aa9f687428f1f19 Mon Sep 17 00:00:00 2001
From: Nic-Sevic <47717887+Nic-Sevic@users.noreply.github.com>
Date: Tue, 17 Sep 2024 16:22:32 -0700
Subject: [PATCH 2/6] fix: syntax issues

---
 WordPress/Docs/Files/FileNameStandard.xml | 38 +++++++++++++----------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
index 6d6f45333a..fc255cb848 100644
--- a/WordPress/Docs/Files/FileNameStandard.xml
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -1,31 +1,35 @@
-<documentation title="File Name Standards">
-<standard>
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd" 
+    title="File Name Standards"
+    >
+    <standard>
     <![CDATA[
-        Ensures that file names meet the following standards:
-        - Filenames should be all lowercase with hyphens separating words.
-        - Class file names should be based on the class name with "class-" prepended.
-        - Files in `wp-includes` containing template tags should end in `-template`.
+    Ensures that file names meet the following standards:
+    - Filenames should be all lowercase with hyphens separating words.
+    - Class file names should be based on the class name with "class-" prepended.
+    - Files in `wp-includes` containing template tags should end in `-template`.
 
-        If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+    If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
     ]]>
     </standard>
     <code_comparison>
         <code title="Valid: All lowercase with only hyphens as word separators and proper use of prefix/suffix.">
         <![CDATA[
-echo taxonomy<em>-</em>my<em>-</em>term.inc
-echo <em>s</em>ome<em>f</em>ile.inc
-echo <em>class</em>-testsample.inc
-echo other<em>-</em>punctuation.inc
-echo general<em>-template</em>.php
+taxonomy<em>-</em>my<em>-</em>term.inc
+<em>s</em>ome<em>f</em>ile.inc
+<em>class</em>-testsample.inc
+other<em>-</em>punctuation.inc
+general<em>-template</em>.php
         ]]>
         </code>
         <code title="Invalid: Use of other punctuation, uppercase, or missing prefix/suffix.">
         <![CDATA[
-echo taxonomy-my<em>_</em>term.inc.
-echo <em>S</em>ome<em>F</em>ile.inc
-echo <em>testsample</em>-unit-2.inc
-echo other<em>+</em>punctuation<em>#</em>.inc
-echo <em>general</em>.php
+taxonomy-my<em>_</em>term.inc.
+<em>S</em>ome<em>F</em>ile.inc
+<em>testsample</em>-unit-2.inc
+other<em>+</em>punctuation<em>#</em>.inc
+<em>general</em>.php
         ]]>
         </code>
     </code_comparison>

From a08e0925f387940b2a83c233c3e5a3054d3df8bc Mon Sep 17 00:00:00 2001
From: Jason Kenison <jason.kenison@gmail.com>
Date: Tue, 26 Aug 2025 13:41:05 -0700
Subject: [PATCH 3/6] initial edits, breaking up standards

---
 WordPress/Docs/Files/FileNameStandard.xml | 28 +++++++++++++++--------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
index fc255cb848..7365dadfdd 100644
--- a/WordPress/Docs/Files/FileNameStandard.xml
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -5,30 +5,40 @@
     >
     <standard>
     <![CDATA[
-    Ensures that file names meet the following standards:
-    - Filenames should be all lowercase with hyphens separating words.
-    - Class file names should be based on the class name with "class-" prepended.
-    - Files in `wp-includes` containing template tags should end in `-template`.
-
-    If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+    Filenames should be all lowercase with hyphens separating words. If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: All lowercase with only hyphens as word separators and proper use of prefix/suffix.">
+        <code title="Valid: All lowercase with only hyphens as word separators.">
         <![CDATA[
 taxonomy<em>-</em>my<em>-</em>term.inc
 <em>s</em>ome<em>f</em>ile.inc
 <em>class</em>-testsample.inc
 other<em>-</em>punctuation.inc
-general<em>-template</em>.php
         ]]>
         </code>
-        <code title="Invalid: Use of other punctuation, uppercase, or missing prefix/suffix.">
+        <code title="Invalid: Use of other punctuation or mixed case.">
         <![CDATA[
 taxonomy-my<em>_</em>term.inc.
 <em>S</em>ome<em>F</em>ile.inc
 <em>testsample</em>-unit-2.inc
 other<em>+</em>punctuation<em>#</em>.inc
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+   Files in `wp-includes` containing template tags should end in `-template`.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: File name with proper prefix/suffix.">
+        <![CDATA[
+general<em>-template</em>.php
+        ]]>
+        </code>
+        <code title="Invalid: File name missing prefix/suffix.">
+        <![CDATA[
 <em>general</em>.php
         ]]>
         </code>

From 68a27736189118a9a5b013275cec2c5f4d875b24 Mon Sep 17 00:00:00 2001
From: Jason Kenison <jason.kenison@gmail.com>
Date: Tue, 26 Aug 2025 14:57:18 -0700
Subject: [PATCH 4/6] updated examples, added new mimetype examples

---
 WordPress/Docs/Files/FileNameStandard.xml | 50 ++++++++++++++++++++---
 1 file changed, 45 insertions(+), 5 deletions(-)

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
index 7365dadfdd..4686b0efa2 100644
--- a/WordPress/Docs/Files/FileNameStandard.xml
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -5,11 +5,32 @@
     >
     <standard>
     <![CDATA[
-    Filenames should be all lowercase with hyphens separating words. If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+File name must not be a mimetype sublevel only file names, such as `plain.php`.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: All lowercase with only hyphens as word separators.">
+        <code title="Valid: Is not a mimetype only file name.">
+        <![CDATA[
+<em>taxonomy-term</em>.inc
+<em>class-test-sample</em>.php
+<em>other-punctuation</em>.inc
+        ]]>
+        </code>
+        <code title="Invalid: Is a mimetype only file name.">
+        <![CDATA[
+<em>text-plain</em>.php
+<em>html</em>.inc
+<em>richtext</em>.php
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+Filenames should be all lowercase with hyphens separating words. If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Lowercase and `-` separators.">
         <![CDATA[
 taxonomy<em>-</em>my<em>-</em>term.inc
 <em>s</em>ome<em>f</em>ile.inc
@@ -17,17 +38,36 @@ taxonomy<em>-</em>my<em>-</em>term.inc
 other<em>-</em>punctuation.inc
         ]]>
         </code>
-        <code title="Invalid: Use of other punctuation or mixed case.">
+        <code title="Invalid: Other punctuation or mixed case.">
         <![CDATA[
-taxonomy-my<em>_</em>term.inc.
+taxonomy-my<em>_</em>term.inc
 <em>S</em>ome<em>F</em>ile.inc
-<em>testsample</em>-unit-2.inc
+<em>testsample</em>-Unit2.inc
 other<em>+</em>punctuation<em>#</em>.inc
         ]]>
         </code>
     </code_comparison>
     <standard>
     <![CDATA[
+    Class file names should be based on the class name with `class-` prepended.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: File name matches prefix and class.">
+        <![CDATA[
+<em>class-bulkupdater</em>.php
+        ]]>
+        </code>
+        <code title="Invalid: File name missing prefix or class.">
+        <![CDATA[
+<em>class.</em>bulk-updater.php
+<em>bulkupdater-class</em>.php
+class-<em>CustomFormatter</em>.php
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
    Files in `wp-includes` containing template tags should end in `-template`.
     ]]>
     </standard>

From 200cdfabfa5d6595e8670e008782d2eab4997965 Mon Sep 17 00:00:00 2001
From: Jason Kenison <jason.kenison@gmail.com>
Date: Tue, 2 Sep 2025 13:57:26 -0700
Subject: [PATCH 5/6] clarified code examples and standard text

---
 WordPress/Docs/Files/FileNameStandard.xml | 41 +++++------------------
 1 file changed, 9 insertions(+), 32 deletions(-)

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
index 4686b0efa2..91f5fa0698 100644
--- a/WordPress/Docs/Files/FileNameStandard.xml
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -1,40 +1,18 @@
 <?xml version="1.0"?>
 <documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd" 
-    title="File Name Standards"
+    title="File Name"
     >
     <standard>
     <![CDATA[
-File name must not be a mimetype sublevel only file names, such as `plain.php`.
-    ]]>
-    </standard>
-    <code_comparison>
-        <code title="Valid: Is not a mimetype only file name.">
-        <![CDATA[
-<em>taxonomy-term</em>.inc
-<em>class-test-sample</em>.php
-<em>other-punctuation</em>.inc
-        ]]>
-        </code>
-        <code title="Invalid: Is a mimetype only file name.">
-        <![CDATA[
-<em>text-plain</em>.php
-<em>html</em>.inc
-<em>richtext</em>.php
-        ]]>
-        </code>
-    </code_comparison>
-    <standard>
-    <![CDATA[
-Filenames should be all lowercase with hyphens separating words. If `$is_theme` property is set to `true` certain theme specific exceptions are made for underscores.
+    Filenames should be all lowercase with hyphens separating words.
     ]]>
     </standard>
     <code_comparison>
         <code title="Valid: Lowercase and `-` separators.">
         <![CDATA[
 taxonomy<em>-</em>my<em>-</em>term.inc
-<em>s</em>ome<em>f</em>ile.inc
-<em>class</em>-testsample.inc
+<em>s</em>ome-<em>f</em>ile.inc
 other<em>-</em>punctuation.inc
         ]]>
         </code>
@@ -42,7 +20,6 @@ other<em>-</em>punctuation.inc
         <![CDATA[
 taxonomy-my<em>_</em>term.inc
 <em>S</em>ome<em>F</em>ile.inc
-<em>testsample</em>-Unit2.inc
 other<em>+</em>punctuation<em>#</em>.inc
         ]]>
         </code>
@@ -55,24 +32,24 @@ other<em>+</em>punctuation<em>#</em>.inc
     <code_comparison>
         <code title="Valid: File name matches prefix and class.">
         <![CDATA[
-<em>class-bulkupdater</em>.php
+<em>class</em>-<em>bulk-updater</em>.php
         ]]>
         </code>
         <code title="Invalid: File name missing prefix or class.">
         <![CDATA[
-<em>class.</em>bulk-updater.php
-<em>bulkupdater-class</em>.php
-class-<em>CustomFormatter</em>.php
+class<em>.</em>bulk-updater.php
+<em>bulk-updater</em>.php
+bulk-updater<em>-class</em>.php
         ]]>
         </code>
     </code_comparison>
     <standard>
     <![CDATA[
-   Files in `wp-includes` containing template tags should end in `-template`.
+    Non-class files in the directory `wp-includes` with a "@subpackage Template" tag should use the `-template` suffix.
     ]]>
     </standard>
     <code_comparison>
-        <code title="Valid: File name with proper prefix/suffix.">
+        <code title="Valid: File name with proper suffix.">
         <![CDATA[
 general<em>-template</em>.php
         ]]>

From 768e4a9e1aef2955f4d8dbc55127023f9a53f227 Mon Sep 17 00:00:00 2001
From: Jason Kenison <jason.kenison@gmail.com>
Date: Tue, 2 Sep 2025 14:05:46 -0700
Subject: [PATCH 6/6] updated for spelling in broken "some" word

---
 WordPress/Docs/Files/FileNameStandard.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/WordPress/Docs/Files/FileNameStandard.xml b/WordPress/Docs/Files/FileNameStandard.xml
index 91f5fa0698..25597b602a 100644
--- a/WordPress/Docs/Files/FileNameStandard.xml
+++ b/WordPress/Docs/Files/FileNameStandard.xml
@@ -12,14 +12,14 @@
         <code title="Valid: Lowercase and `-` separators.">
         <![CDATA[
 taxonomy<em>-</em>my<em>-</em>term.inc
-<em>s</em>ome-<em>f</em>ile.inc
+<em>some</em>-<em>file</em>.inc
 other<em>-</em>punctuation.inc
         ]]>
         </code>
         <code title="Invalid: Other punctuation or mixed case.">
         <![CDATA[
 taxonomy-my<em>_</em>term.inc
-<em>S</em>ome<em>F</em>ile.inc
+<em>Some</em>-<em>File</em>.inc
 other<em>+</em>punctuation<em>#</em>.inc
         ]]>
         </code>