From aecb113edb9004a0945deddc34afb8705653aed5 Mon Sep 17 00:00:00 2001
From: Marco Martins <marcomartins@fimdalinha.com>
Date: Thu, 20 Jun 2019 13:16:37 +0300
Subject: [PATCH] Add the documentation for
 WordPress.Arrays.CommaAfterArrayItem

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

diff --git a/WordPress/Docs/Arrays/CommaAfterArrayItemStandard.xml b/WordPress/Docs/Arrays/CommaAfterArrayItemStandard.xml
new file mode 100644
index 0000000000..65e00c5063
--- /dev/null
+++ b/WordPress/Docs/Arrays/CommaAfterArrayItemStandard.xml
@@ -0,0 +1,96 @@
+<documentation title="Comma After Array Item">
+    <standard>
+    <![CDATA[
+    Enforces a comma after each array item and the spacing around it.
+    ]]>
+    </standard>
+    <code_comparison>
+       <code title="Valid: Items inline, comma not needed.">
+        <![CDATA[
+$arr = <em>[</em> 'a', 'b', 'c' <em>]</em>;
+        ]]>
+        </code>
+        <code title="Invalid: Items inline, comma not needed.">
+        <![CDATA[
+$arr = <em>[</em> 'a', 'b', 'c', <em>]</em>;
+        ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: Comma after item on their own line.">
+        <![CDATA[
+$arr = <em>[</em>
+    'a',
+    'b',
+    'c',
+<em>]</em>;
+        ]]>
+        </code>
+
+        <code title="Invalid: Missing comma after item on their own line.">
+        <![CDATA[
+$arr = <em>[</em>
+    'a',
+    'b',
+    'c'
+<em>]</em>;
+        ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: Comma after item on their own line (associative array).">
+        <![CDATA[
+$arr = <em>[</em>
+    1 => 'value',
+    2 => <em>[</em> 1 <em>]</em>,
+    3 => 'c',
+<em>]</em>;
+        ]]>
+        </code>
+        <code title="Invalid: Missing comma after item on their own line (associative array)">
+        <![CDATA[
+$arr = <em>[</em>
+    1 => 'value',
+    2 => <em>[</em> 1 <em>]</em>,
+    3 => 'c'
+<em>]</em>;
+        ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: No spacing before comma.">
+     <![CDATA[
+$arr = <em>[</em>
+    1 => 'value',
+    2 => <em>[</em> 1 <em>]</em>,
+    3 => 'c',
+<em>]</em>;
+    ]]>
+        </code>
+        <code title="Invalid: Spacing before comma.">
+     <![CDATA[
+$arr = <em>[</em>
+    1 => 'value'  ,
+    2 => <em>[</em> 1 <em>]</em>,
+    3 => 'c'       , /* Comment. */
+<em>]</em>;
+    ]]>
+        </code>
+    </code_comparison>
+
+    <code_comparison>
+        <code title="Valid: Single spacing after comma.">
+     <![CDATA[
+$arr = <em>[</em> 'a', 'b', 'c' <em>]</em>;
+    ]]>
+        </code>
+        <code title="Invalid: Multiple or no spacing after comma.">
+     <![CDATA[
+$arr = <em>[</em> 'a','b',    'c' <em>]</em>;
+    ]]>
+        </code>
+    </code_comparison>
+</documentation>