From ac45798ad4fa71b38932987da93d9e62b57f2e39 Mon Sep 17 00:00:00 2001
From: Rafael Funchal <rafaelfunchal@gmail.com>
Date: Tue, 17 Sep 2024 11:58:29 -0700
Subject: [PATCH] Adding documentation for
 WordPress.Arrays.ArrayDeclarationSpacing

---
 .../ArrayDeclarationSpacingStandard.xml       | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 WordPress/Docs/Arrays/ArrayDeclarationSpacingStandard.xml

diff --git a/WordPress/Docs/Arrays/ArrayDeclarationSpacingStandard.xml b/WordPress/Docs/Arrays/ArrayDeclarationSpacingStandard.xml
new file mode 100644
index 000000000..f70bbac50
--- /dev/null
+++ b/WordPress/Docs/Arrays/ArrayDeclarationSpacingStandard.xml
@@ -0,0 +1,51 @@
+<?xml version="1.0"?>
+<documentation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:noNamespaceSchemaLocation="https://phpcsstandards.github.io/PHPCSDevTools/phpcsdocs.xsd"
+    title="Array Declaration Spacing"
+    >
+    <standard>
+    <![CDATA[
+    When an array uses associative keys, each pair of key and value must start on a new line.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: There is only one pair of key and value per line.">
+        <![CDATA[
+$args = array(
+    <em>'post_id' => 22,
+    'category' => 1</em>
+);
+        ]]>
+        </code>
+        <code title="Invalid: More than one pair of key and value per line.">
+        <![CDATA[
+$args = array(
+    <em>'post_id' => 22, 'category' => 1</em>
+);
+        ]]>
+        </code>
+    </code_comparison>
+    <standard>
+    <![CDATA[
+    Each item in a multi-line array must be on a new line.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Only one array item per line.">
+        <![CDATA[
+$args = array(
+    <em>'post_id',
+    'comment_count',
+    'post_type'</em>
+);
+        ]]>
+        </code>
+        <code title="Invalid: Multiple array items in the same line.">
+        <![CDATA[
+$args = array(
+    <em>'post_id', 'comment_count', 'post_type'</em>
+);
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>