Add generator docs for Generic.Arrays

Author: hopkins-space

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>