diff --git a/docs/_includes/getting-started/accessibility.html b/docs/_includes/getting-started/accessibility.html deleted file mode 100644 index cb9b3e11e1..0000000000 --- a/docs/_includes/getting-started/accessibility.html +++ /dev/null @@ -1,26 +0,0 @@ -
-

Accessibility

-

Bootstrap follows common web standards and—with minimal extra effort—can be used to create sites that are accessible to those using AT.

- -

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)

-{% highlight html %} - - Skip to main content -
- The main page content. -
- -{% 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 and Penn State's AccessAbility.

- -

Additional resources

- -
diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md new file mode 100644 index 0000000000..4d95a1631a --- /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 AT. + +### 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 `` tag. [(read why)](http://a11yproject.com/posts/skip-nav-links/) + +{% highlight html %} + + Skip to main content +
+ The main page content. +
+ +{% endhighlight %} + +### Nested headings + +When nesting headings (`

` - `

`), your primary document header should be an `

`. Subsequent headings should make logical use of `

` - `

` 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)