]> git.ipfire.org Git - thirdparty/bootstrap.git/commitdiff
Port #14543 over to hosted docs
authorChris Rebert <code@rebertia.com>
Sat, 27 Sep 2014 00:07:19 +0000 (17:07 -0700)
committerChris Rebert <code@rebertia.com>
Sat, 27 Sep 2014 00:07:19 +0000 (17:07 -0700)
getting-started/index.html

index 94a79db6c6ed7d669a29cbb211b7024f4b5b63e2..7775f6bdac0ab9f464c51a299ae5f9a02e5d0b1c 100644 (file)
@@ -650,6 +650,11 @@ Copy any changes made here over to the README too. -->
 <span class="p">})</span>
 <span class="nt">&lt;/script&gt;</span></code></pre></div>
   <p>Want to see an example? <a href="http://jsbin.com/OyaqoDO/2">Check out this JS Bin demo.</a></p>
+
+  <h3 id="support-validators">Validators</h3>
+  <p>In order to provide the best possible experience to old and buggy browsers, Bootstrap uses <a href="http://browserhacks.com">CSS browser hacks</a> in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren't yet fully standardized, but these are used purely for progressive enhancement.</p>
+  <p>These validation warnings don't matter in practice since the non-hacky portion of our CSS does fully validate and the hacky portions don't interfere with the proper functioning of the non-hacky portion, hence why we deliberately ignore these particular warnings.</p>
+  <p>Our HTML docs likewise have some trivial and inconsequential HTML validation warnings due to our inclusion of <a href="#support-ie-compatibility-modes">X-UA-Compatible <code>&lt;meta&gt;</code> tags</a> to avoid Internet Explorer issues and our inclusion of a workaround for <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=654072">a certain Firefox bug</a>.</p>
 </div>
 
 <div class="bs-docs-section">
@@ -855,6 +860,7 @@ Copy any changes made here over to the README too. -->
     <li><a href="#support-browser-zooming">Browser zooming</a></li>
     <li><a href="#support-printing">Printer viewports</a></li>
     <li><a href="#support-android-stock-browser">Android stock browser</a></li>
+    <li><a href="#support-validators">Validators</a></li>
   </ul>
 </li>
 <li>