From c685c96630e985d0c506ed0621b21f379cf3500f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcel=20St=C3=B6r?= Date: Thu, 22 Aug 2024 15:56:07 +0200 Subject: [PATCH] Add note about collection element order Through a discussion at https://quarkusio.zulipchat.com/#narrow/stream/187030-users/topic/YAML.20config.20mapping.20collections.3A.20Set.20!.3D.20List.20wrt.20value.20order with @radcortez we confirmed only `List` mappings maintain order --- docs/src/main/asciidoc/config-mappings.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/src/main/asciidoc/config-mappings.adoc b/docs/src/main/asciidoc/config-mappings.adoc index f702787756118..fda53c12d5aa2 100644 --- a/docs/src/main/asciidoc/config-mappings.adoc +++ b/docs/src/main/asciidoc/config-mappings.adoc @@ -388,6 +388,8 @@ The `List` or `Set` mappings can use xref:config-reference.adoc#indexed-properti configuration values in mapping groups. For collection with simple element types like `String`, their configuration value is a comma separated string. +NOTE: Only the `List` mapping can maintain element order. Hence, with `Set` mappings the element order is not maintained from the configuration files but is random. + ==== Maps ==== A config mapping is also able to map a `Map`: