Merge branch 'generic_arrays_docs' of https://github.com/hopkins-space/PHP_CodeSniffer

Author: gsherwood

src/Standards/Generic/Docs/Arrays/DisallowLongArraySyntaxStandard.xml

@@ -0,0 +1,23 @@
+<documentation title="Short Array Syntax">
+    <standard>
+    <![CDATA[
+    Short array syntax must be used to define arrays.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Short form of array.">
+        <![CDATA[
+$arr = <em>[</em>
+    'foo' => 'bar',
+<em>]</em>;
+        ]]>
+        </code>
+        <code title="Invalid: Long form of array.">
+        <![CDATA[
+$arr = <em>array(</em>
+    'foo' => 'bar',
+<em>)</em>;
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>

src/Standards/Generic/Docs/Arrays/DisallowShortArraySyntaxStandard.xml

@@ -0,0 +1,23 @@
+<documentation title="Long Array Syntax">
+    <standard>
+    <![CDATA[
+    Long array syntax must be used to define arrays.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Long form of array.">
+        <![CDATA[
+$arr = <em>array(</em>
+    'foo' => 'bar',
+<em>)</em>;
+        ]]>
+        </code>
+        <code title="Invalid: Short form of array.">
+        <![CDATA[
+$arr = <em>[</em>
+    'foo' => 'bar',
+<em>]</em>;
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>