From e7dcd5b50c91338255fd303184b98bcdd88fac84 Mon Sep 17 00:00:00 2001
From: Tomas Nozicka <tnozicka@gmail.com>
Date: Thu, 23 Oct 2025 18:42:46 +0200
Subject: [PATCH] Include description for allowed enum values for elements
 within a slice

---
 pkg/generators/openapi.go      | 6 +++++-
 pkg/generators/openapi_test.go | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/pkg/generators/openapi.go b/pkg/generators/openapi.go
index 5d58754a7..af843665e 100644
--- a/pkg/generators/openapi.go
+++ b/pkg/generators/openapi.go
@@ -1021,9 +1021,14 @@ func (g openAPITypeWriter) generateProperty(m *types.Member, parent *types.Type)
 		return err
 	}
 	g.Do("SchemaProps: spec.SchemaProps{\n", nil)
+	t := resolveAliasAndPtrType(m.Type)
 	var extraComments []string
 	if enumType, isEnum := g.enumContext.EnumType(m.Type); isEnum {
 		extraComments = enumType.DescriptionLines()
+	} else if t.Kind == types.Slice {
+		if enumType, isEnum := g.enumContext.EnumType(t.Elem); isEnum {
+			extraComments = enumType.DescriptionLines()
+		}
 	}
 	g.generateDescription(append(m.CommentLines, extraComments...))
 	jsonTags := getJsonTags(m)
@@ -1040,7 +1045,6 @@ func (g openAPITypeWriter) generateProperty(m *types.Member, parent *types.Type)
 	if err != nil {
 		return err
 	}
-	t := resolveAliasAndPtrType(m.Type)
 	// If we can get a openAPI type and format for this type, we consider it to be simple property
 	typeString, format := openapi.OpenAPITypeFormat(t.String())
 	if typeString != "" {
diff --git a/pkg/generators/openapi_test.go b/pkg/generators/openapi_test.go
index 55be4c557..94fd6f68e 100644
--- a/pkg/generators/openapi_test.go
+++ b/pkg/generators/openapi_test.go
@@ -2077,7 +2077,8 @@ Enum: []interface{}{"a", "b"},
 },
 },
 "List": {
-SchemaProps: spec.SchemaProps{
+SchemaProps: spec.SchemaProps{`+"\n"+
+				"Description: \"Possible enum values:\\n - `\\\"a\\\"` is a.\\n - `\\\"b\\\"` is b.\","+`
 Type: []string{"array"},
 Items: &spec.SchemaOrArray{
 Schema: &spec.Schema{