Array elements in Schema have duplicate descriptions

[Andrew3431]

When schema has an array element present, the description is duplicated and is shown twice in the UI.

      "Filter": {
        "required": [
          "itemIds",
          "itemNames"
        ],
        "type": "object",
        "properties": {
          "itemIds": {
            "uniqueItems": true,
            "type": "array",
            "description": "A list of items",
            "items": {
              "type": "string",
              "description": "A list of items"
            }
          },
          "itemNames": {
            "uniqueItems": true,
            "type": "array",
            "description": "A list of item names",
            "items": {
              "type": "string",
              "description": "A list of item names"
            }
          }
        },
        "description": "The list of filters to use"
      }

FilterModel.java

    public class Filter {

        @Schema(description = "A list of items", required = true)
        Set<String> itemIds = new HashSet<>();

        @Schema(description = "A list of item names", required = true)
        Set<String> itemNames = new HashSet<>();
    }

How to avoid giving a description for the variable as well as giving a description for array item ?
I just want one description to be present.

[bnasslahsen]

Hi @Andrew3431,

In order to have the description for the array only, you should use `@ArraySchema. Here is an example:

  @ArraySchema(arraySchema = @Schema(description = "A list of items"))
  Set<String> itemIds = new HashSet<>();
  @ArraySchema(arraySchema = @Schema(description = "A list of item names"))
  Set<String> itemNames = new HashSet<>();