aboutsummaryrefslogtreecommitdiff
path: root/docs/getting-started/accessibility.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2014-07-11 23:46:47 -0700
committerMark Otto <[email protected]>2014-07-11 23:46:47 -0700
commit2bbbf55180524c6e7510dc15d49fe6e17e8ff724 (patch)
tree4f75b546ef2e67b7235af5dda9db45d06b490129 /docs/getting-started/accessibility.md
parent28c946af900f7edf1bfb03e2ad466687a0d5c464 (diff)
downloadbootstrap-2bbbf55180524c6e7510dc15d49fe6e17e8ff724.tar.xz
bootstrap-2bbbf55180524c6e7510dc15d49fe6e17e8ff724.zip
Move accessibility to markdown
Diffstat (limited to 'docs/getting-started/accessibility.md')
-rw-r--r--docs/getting-started/accessibility.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md
new file mode 100644
index 000000000..4d95a1631
--- /dev/null
+++ b/docs/getting-started/accessibility.md
@@ -0,0 +1,31 @@
+---
+layout: page
+title: Accessibility
+---
+
+Bootstrap follows common web standards and—with minimal extra effort—can be used to create sites that are accessible to those using <abbr title="Assistive Technology" class="initialism">AT</abbr>.
+
+### Skip navigation
+
+If your navigation contains many links and comes before the main content in the DOM, add a `Skip to main content` link immediately after your opening `<body>` tag. [(read why)](http://a11yproject.com/posts/skip-nav-links/)
+
+{% highlight html %}
+<body>
+ <a href="#content" class="sr-only sr-only-focusable">Skip to main content</a>
+ <div class="container" id="content">
+ The main page content.
+ </div>
+</body>
+{% endhighlight %}
+
+### Nested headings
+
+When nesting headings (`<h1>` - `<h6>`), your primary document header should be an `<h1>`. Subsequent headings should make logical use of `<h2>` - `<h6>` such that screen readers can construct a table of contents for your pages.
+
+Learn more at [HTML CodeSniffer](http://squizlabs.github.io/HTML_CodeSniffer/Standards/Section508/) and [Penn State's Accessability](http://accessibility.psu.edu/headings).
+
+### Additional resources
+
+- ["HTML Codesniffer" bookmarklet for identifying accessibility issues](https://github.com/squizlabs/HTML_CodeSniffer)
+- [The A11Y Project](http://a11yproject.com/)
+- [MDN accessibility documentation](https://developer.mozilla.org/en-US/docs/Accessibility)