aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2014-09-06 12:24:45 -0700
committerMark Otto <[email protected]>2014-09-06 12:24:45 -0700
commitf5a05fe9e96bb0ee877e4b19149b9512eeb52956 (patch)
tree77bba32965123bd1ae623fb0fee1a485dc596f55 /docs
parent5603311acd6f06c15802ebdae5d94a6b2de6bb22 (diff)
parentc447cc7bc18b61aa5fefb54b821f822cbf222ae9 (diff)
downloadbootstrap-f5a05fe9e96bb0ee877e4b19149b9512eeb52956.tar.xz
bootstrap-f5a05fe9e96bb0ee877e4b19149b9512eeb52956.zip
Merge pull request #14543 from twbs/validation-docs
Add section to docs explaining our stance on validators
Diffstat (limited to 'docs')
-rw-r--r--docs/_includes/getting-started/browser-device-support.html5
-rw-r--r--docs/_includes/nav/getting-started.html1
2 files changed, 6 insertions, 0 deletions
diff --git a/docs/_includes/getting-started/browser-device-support.html b/docs/_includes/getting-started/browser-device-support.html
index 6dde94bdb..f55bd0be3 100644
--- a/docs/_includes/getting-started/browser-device-support.html
+++ b/docs/_includes/getting-started/browser-device-support.html
@@ -189,4 +189,9 @@ $(function () {
</script>
{% endhighlight %}
<p>Want to see an example? <a href="http://jsbin.com/kuvoz/1">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>
diff --git a/docs/_includes/nav/getting-started.html b/docs/_includes/nav/getting-started.html
index 54927c22a..4ae8777c7 100644
--- a/docs/_includes/nav/getting-started.html
+++ b/docs/_includes/nav/getting-started.html
@@ -52,6 +52,7 @@
<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>