diff --git a/config/site.yaml b/config/site.yaml
index de48656e..dfe31e4f 100644
--- a/config/site.yaml
+++ b/config/site.yaml
@@ -6,3 +6,5 @@ taxonomies: [category,tag]
summary:
size: 300
+redirects:
+ /getting-help: /troubleshooting/getting-help
diff --git a/pages/02.getting-help/docs.md b/pages/02.troubleshooting/01.getting-help/docs.md
similarity index 100%
rename from pages/02.getting-help/docs.md
rename to pages/02.troubleshooting/01.getting-help/docs.md
diff --git a/pages/02.troubleshooting/02.common-problems/docs.md b/pages/02.troubleshooting/02.common-problems/docs.md
new file mode 100644
index 00000000..50cc4aac
--- /dev/null
+++ b/pages/02.troubleshooting/02.common-problems/docs.md
@@ -0,0 +1,42 @@
+---
+title: Common problems
+metadata:
+ description: Commonly encountered issues when using Select2.
+taxonomy:
+ category: docs
+---
+
+### Select2 does not function properly when I use it inside a Bootstrap modal.
+
+This issue occurs because Bootstrap modals tend to steal focus from other elements outside of the modal. Since by default, Select2 [attaches the dropdown menu to the `` element](/dropdown#dropdown-placement), it is considered "outside of the modal".
+
+To avoid this problem, you may attach the dropdown to the modal itself with the [dropdownParent](/dropdown#dropdown-placement) setting:
+
+```
+
+ ...
+
+ ...
+
+
+...
+
+
+```
+
+This will cause the dropdown to be attached to the modal, rather than the `` element.
+
+**Alternatively**, you may simply globally override Bootstrap's behavior:
+
+```
+// Do this before you initialize any of your modals
+$.fn.modal.Constructor.prototype.enforceFocus = function() {};
+```
+
+See [this answer](https://stackoverflow.com/questions/18487056/select2-doesnt-work-when-embedded-in-a-bootstrap-modal/19574076#19574076) for more information.
diff --git a/pages/02.troubleshooting/chapter.md b/pages/02.troubleshooting/chapter.md
new file mode 100644
index 00000000..e4c9f518
--- /dev/null
+++ b/pages/02.troubleshooting/chapter.md
@@ -0,0 +1,11 @@
+---
+title: Troubleshooting
+metadata:
+ description: The chapter covers some common issues you may encounter with Select2, as well as where you can go to get help.
+taxonomy:
+ category: docs
+---
+
+# Troubleshooting
+
+The chapter covers some common issues you may encounter with Select2, as well as where you can go to get help.
\ No newline at end of file
diff --git a/pages/07.dropdown/docs.md b/pages/07.dropdown/docs.md
index 3ded5ae3..10a4a6dd 100644
--- a/pages/07.dropdown/docs.md
+++ b/pages/07.dropdown/docs.md
@@ -55,7 +55,7 @@ If you need to render HTML with your result template, you must wrap your rendere
Select2 can be configured to automatically select the currently highlighted result when the dropdown is closed by using the `selectOnClose` option:
```
-$('select').select2({
+$('#mySelect2').select2({
selectOnClose: true
});
```
@@ -65,7 +65,7 @@ $('select').select2({
Select2 will automatically close the dropdown when an element is selected, similar to what is done with a normal select box. You may use the `closeOnSelect` option to prevent the dropdown from closing when a result is selected:
```
-$('select').select2({
+$('#mySelect2').select2({
closeOnSelect: false
});
```
@@ -85,8 +85,8 @@ Select2 will display the dropdown above the container if there is not enough spa
The `dropdownParent` option allows you to pick an alternative element for the dropdown to be appended to:
```
-$('select').select2({
- dropdownParent: $('#my_amazing_modal')
+$('#mySelect2').select2({
+ dropdownParent: $('#myModal')
});
```