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

* Do not debug-dump for top-level arrays in OpenAPI responses

* Render array without defined items, adjust item type rendering

* Change from "array<type>" to "array of types"

Author: Simran-B

site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html

@@ -122,9 +122,8 @@
                 <ul class="openapi-table">
                   <div class="openapi-table-title">Response Body</div>
                   {{ range $k, $v := $content.content }}
-                    {{ if $v.schema.items }}
+                    {{ if eq $v.schema.type "array" }}
                       {{ $required := false }}
-                      {{ $v }}
                       {{- template "renderProperty" dict "title" $statusId "prop" "" "value" $v.schema "required" $required }}
                     {{ else }}
                       {{ range $prop, $value := $v.schema.properties}}
@@ -179,8 +178,8 @@
   {{ $type := $value.type }}
   {{ $anchor := printf "%s_%s" $title $prop }}
   <li class="openapi-table-row regular-font">
-    {{ if eq $value.type "array" }}
-      {{ $type = printf "[%s]" $value.items.type }}
+    {{ if and (eq $value.type "array") ($value.items.type) }}
+      {{ $type = printf "array of %ss" $value.items.type }}
     {{ else if eq $value.type "object" }}
       {{ $type = "object" }}
     {{ end }}