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/2] 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/2] 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>