Add questions about the dropdown

docs/_includes/options-new/dropdown.html

@@ -0,0 +1,9 @@
+<section>
+  <h1 id="results">
+    Displaying results
+  </h1>
+
+  {% include options-new/dropdown/filtering.html %}
+  {% include options-new/dropdown/selections.html %}
+  {% include options-new/dropdown/placement.html %}
+</section>

docs/_includes/options-new/dropdown/filtering.html

@@ -0,0 +1,23 @@
+<section>
+  <h2>
+    Can I change when search results are loaded?
+  </h2>
+
+  <h3>
+    Can Select2 wait until the user has typed a search term before triggering the request?
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3>
+    Select2 is allowing long search terms, can this be prevented?
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3>
+    I only want the search box if there are enough results
+  </h3>
+
+  {% include options-new/not-written.html %}
+</section>

docs/_includes/options-new/dropdown/placement.html

@@ -0,0 +1,29 @@
+<section>
+  <h2>
+    Can I change how the dropdown is placed?
+  </h2>
+
+  <h3 id="dropdown-attachContainer">
+    Can the dropdown be placed directly after the selection container?
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3 id="dropdownParent">
+    Can I pick an element for the dropdown to be appended to?
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3>
+    I&apos;m using a Bootstrap modal and I can&apos;t use the search box
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3>
+    I&apos;m using jQuery UI and I can&apos;t use the search box
+  </h3>
+
+  {% include options-new/not-written.html %}
+</section>

docs/_includes/options-new/dropdown/selections.html

@@ -0,0 +1,17 @@
+<section>
+  <h2>
+    Can I change how selecting results works?
+  </h2>
+
+  <h3>
+    Can I select the highlighted result when the dropdown is closed?
+  </h3>
+
+  {% include options-new/not-written.html %}
+
+  <h3>
+    Can I prevent the dropdown from closing when a result is selected?
+  </h3>
+
+  {% include options-new/not-written.html %}
+</section>

docs/options-new.html

@@ -22,6 +22,7 @@ slug: options
       {% include options-new/core.html %}
       {% include options-new/data.html %}
       {% include options-new/selections.html %}
+      {% include options-new/dropdown.html %}
       {% include options-new/events.html %}
     </div>
     <div class="col-md-3" role="complementary">