#4307 Brand new arays doc. A small amount of work remains to be done.

[bllewell]

Work remaining:

1. Add the explanations and code examples for the array[] constructor and the string_to_array() function. (Already prepared in draft.)

2. Finish the two sections “The literal for a ‘row’ type value” and “The literal for an array of ‘row’ type values”. (I have the material in draft.)

3. Add a code example for unnest on a multidimensional array.

4. Show how to iterate over array values in PL/pgSQL using the foreach keyword.

5. Proof-read every file.

6. Re-check every code-example by copy-and-paste into ysqlsh. In particular, check that the results in the doc are correctly copied from the ysqlsh output.

7. Run the spell-checker on each file.

I’d expect to finish this before anyone finishes their review.

[stevebang]

A lot to digest, but the content is great. Make the suggested changes and this is ready to merge.

[bllewell]

Closing this now. It acted as the vehicle for excellent feedback from @stevebang and @m-iancu. But has now served its purpose. For various reasons, I'll create a brand new PR for the now-completed work.