From 9082a231a6030dc3191ff86088cd624922a3e345 Mon Sep 17 00:00:00 2001
From: Meysam <meysammahfouzi@users.noreply.github.com>
Date: Wed, 1 Jul 2020 04:11:16 +0200
Subject: [PATCH] Document Select2's dynamic option creation (#5052)

---
 modules/system/assets/ui/docs/select.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/modules/system/assets/ui/docs/select.md b/modules/system/assets/ui/docs/select.md
index 871698389..c2c6e2cc8 100644
--- a/modules/system/assets/ui/docs/select.md
+++ b/modules/system/assets/ui/docs/select.md
@@ -43,6 +43,15 @@ Add the `select-no-search` CSS class to disable searching.
         </select>
     </div>
 
+### Dynamic option creation
+
+In addition to a pre-populated menu of options, Select widgets may dynamically create new options from textual input by the user in the search box. This feature is called "tagging". To enable tagging, set the `tags` option to `true`:
+
+    <select
+        class="form-control custom-select"
+        data-tags="true"
+    ></select>
+
 ## Option groups
 
 Use the `optgroup` element to create option groups.