docs: improve error message

Jamie Tanna · jamietanna · commit eba91d99ed37 · 2024-06-03T17:29:35.000+01:00
Especially now these could be a number of different incompatible types,
we should report this to the user.
diff --git a/pkg/codegen/merge_schemas.go b/pkg/codegen/merge_schemas.go
@@ -121,7 +121,7 @@ func mergeOpenapiSchemas(s1, s2 openapi3.Schema, allOf bool) (openapi3.Schema, e
 	result.AllOf = append(s1.AllOf, s2.AllOf...)
 
 	if s1.Type.Slice() != nil && s2.Type.Slice() != nil && !equalTypes(s1.Type, s2.Type) {
-		return openapi3.Schema{}, errors.New("can not merge incompatible types")
+		return openapi3.Schema{}, fmt.Errorf("can not merge incompatible types: %v, %v", s1.Type.Slice(), s2.Type.Slice())
 	}
 	result.Type = s1.Type
 

Original file line number	Diff line number	Diff line change
`@@ -121,7 +121,7 @@ func mergeOpenapiSchemas(s1, s2 openapi3.Schema, allOf bool) (openapi3.Schema, e`
`121`	`121`	`result.AllOf = append(s1.AllOf, s2.AllOf...)`
`122`	`122`
`123`	`123`	`if s1.Type.Slice() != nil && s2.Type.Slice() != nil && !equalTypes(s1.Type, s2.Type) {`
`124`		`- return openapi3.Schema{}, errors.New("can not merge incompatible types")`
	`124`	`+ return openapi3.Schema{}, fmt.Errorf("can not merge incompatible types: %v, %v", s1.Type.Slice(), s2.Type.Slice())`
`125`	`125`	`}`
`126`	`126`	`result.Type = s1.Type`
`127`	`127`