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>

Author: 4 people

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>