fix #12314

diff --git a/docs/javascript.html b/docs/javascript.html
index bdb1021587b9e102ae7fac9fcb8abf044f65c58a..7d41a0378a1805def32c4b8c302b084b75a41530 100644 (file)
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -102,6 +102,10 @@ $('#myModal').on('show.bs.modal', function (e) {
     <h4>Overlapping modals not supported</h4>
     <p>Be sure not to open a modal while another is still visible. Showing more than one modal at a time requires custom code.</p>
   </div>
+  <div class="bs-callout bs-callout-warning" id="callout-modal-markup-placement">
+    <h4>Modal markup placement</h4>
+    <p>Always try to place a modal's HTML code in a top-level position in your document to avoid other components affecting the modal's appearance and/or functionality.</p>
+  </div>
   <div class="bs-callout bs-callout-warning">
     <h4>Mobile device caveats</h4>
     <p>There are some caveats regarding using modals on mobile devices. <a href="../getting-started/#support-fixed-position-keyboards">See our browser support docs</a> for details.</p>