Do not debug-dump for top-level arrays & improve array rendering in OpenAPI responses

[Simran-B]

Description

This removes dumping the Go data structure for type: array (indirectly checked by looking for items:) at the top-level of a response schema description.

If no item type is defined for an array, still render the property (with an indicated type of array).

For arrays with a defined item type (excluding items: type: ''), display array<type> instead of [type].

Empty item type, array:

• Before https://docs.arangodb.com/stable/develop/http-api/queries/aql-queries/#create-a-cursor_res_201_result
• After https://deploy-preview-427--docs-hugo.netlify.app/stable/develop/http-api/queries/aql-queries/#create-a-cursor_res_201_result

No debug-dumping of top-level arrays, array<object> instead of [object]:

• Before https://docs.arangodb.com/stable/develop/http-api/queries/aql-queries/#list-all-aql-optimizer-rules_res_200_
• After https://deploy-preview-427--docs-hugo.netlify.app/stable/develop/http-api/queries/aql-queries/#list-all-aql-optimizer-rules_res_200_

Array with no items defined:

• We don't seem to have an example for this but I tested it locally
• Now displays a clickable array item instead of nothing

      responses:
        '200':
          description: |
            The list of collections
          content:
            application/json:
              schema:
                description: |
                  The data type is an array but without specification of its elements.
                type: array

Upstream PRs

• 3.10:
• 3.11:
• 3.12:

[arangodb-docs-automation]

Deploy Preview Available Via
https://deploy-preview-427--docs-hugo.netlify.app