From 57c9813cc5a47a5c091665a71018129a3847c950 Mon Sep 17 00:00:00 2001
From: Simran Spiller <simran@arangodb.com>
Date: Mon, 15 Jan 2024 12:23:16 +0100
Subject: [PATCH 1/3] Do not debug-dump for top-level arrays in OpenAPI
 responses

---
 .../layouts/_default/_markup/render-codeblock-openapi.html      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html b/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
index bcd5304516..2c99826813 100644
--- a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
+++ b/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
@@ -124,7 +124,7 @@
                   {{ range $k, $v := $content.content }}
                     {{ if $v.schema.items }}
                       {{ $required := false }}
-                      {{ $v }}
+                      {{/* TODO: Improve array rendering */}}
                       {{- template "renderProperty" dict "title" $statusId "prop" "" "value" $v.schema "required" $required }}
                     {{ else }}
                       {{ range $prop, $value := $v.schema.properties}}

From 568a92fe4b4eb287e09d1b7ef76e50f137755561 Mon Sep 17 00:00:00 2001
From: Simran Spiller <simran@arangodb.com>
Date: Mon, 15 Jan 2024 13:42:22 +0100
Subject: [PATCH 2/3] Render array without defined items, adjust item type
 rendering

---
 .../layouts/_default/_markup/render-codeblock-openapi.html | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html b/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
index 2c99826813..f29b760ebf 100644
--- a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
+++ 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 }}
-                      {{/* TODO: Improve array rendering */}}
                       {{- 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<%s>" $value.items.type }}
     {{ else if eq $value.type "object" }}
       {{ $type = "object" }}
     {{ end }}

From cec1c627bd5afab1a745e0eb9cf9349367a9e3ed Mon Sep 17 00:00:00 2001
From: Simran Spiller <simran@arangodb.com>
Date: Tue, 16 Jan 2024 14:27:57 +0100
Subject: [PATCH 3/3] Change from "array<type>" to "array of types"

---
 .../layouts/_default/_markup/render-codeblock-openapi.html      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html b/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
index f29b760ebf..6e4aa5e86a 100644
--- a/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
+++ b/site/themes/arangodb-docs-theme/layouts/_default/_markup/render-codeblock-openapi.html
@@ -179,7 +179,7 @@
   {{ $anchor := printf "%s_%s" $title $prop }}
   <li class="openapi-table-row regular-font">
     {{ if and (eq $value.type "array") ($value.items.type) }}
-      {{ $type = printf "array<%s>" $value.items.type }}
+      {{ $type = printf "array of %ss" $value.items.type }}
     {{ else if eq $value.type "object" }}
       {{ $type = "object" }}
     {{ end }}