From eefd218f96c8644eed2869408871922cdada33a1 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

Co-authored-by: RafaelFunchal <RafaelFunchal@users.noreply.github.com>
Co-authored-by: mattgaldino <mattgaldino@users.noreply.github.com>
Co-authored-by: Rodrigo Primo <rodrigoprimo@users.noreply.github.com>
Co-authored-by: Juliette <663378+jrfnl@users.noreply.github.com>
---
 .../ArrayDeclarationSpacingStandard.xml       | 58 +++++++++++++++++++
 1 file changed, 58 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 0000000000..9b61acc2aa
--- /dev/null
+++ b/WordPress/Docs/Arrays/ArrayDeclarationSpacingStandard.xml
@@ -0,0 +1,58 @@
+<?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[
+    Multi-item arrays with explicit keys must be declared as multi-line arrays.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Multi-item array with explicit keys declared as multi-line.">
+        <![CDATA[
+$args = array(
+    <em>'cat'   => 1</em>,
+    <em>'paged' => 2</em>,
+);
+        ]]>
+        </code>
+        <code title="Invalid: Single line multi-item array with explicit keys.">
+        <![CDATA[
+$args = array( <em>'cat' => 1, 'paged' => 2</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[
+$post_types = array(
+    <em>'post'</em>,
+    <em>'page'</em>,
+);
+
+$args = array(
+    <em>'cat'   => 1</em>,
+    <em>'paged' => 2</em>,
+);
+        ]]>
+        </code>
+        <code title="Invalid: More than one item per line in a multi-line array.">
+        <![CDATA[
+$post_types = array(
+    <em>'post', 'page'</em>,
+);
+
+
+$args = array(
+    <em>'cat' => 1, 'paged' => 2</em>,
+);
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>