Permalink
Browse files

a few grammar/style/punctuation tweaks in the content, mostly for con…

…sistency
  • Loading branch information...
kswedberg committed Jan 25, 2012
1 parent acb1d01 commit 9db7714abb20ef8200f2151f4e0951a2db1c5947
View
@@ -4,4 +4,4 @@ tags: fallback
kind: css
polyfillurls:
-CSS Animations are still in a flux. The Working Group has [decided to provide](http://www.w3.org/2012/01/13-svg-minutes.html#action02) a universal animation spec that would work across CSS, SVG and HTML. For now, either use animations only to provide non-essential aesthetic enhancements or use feature detection to provide an alternative experience for browsers that do not support this feature.
+CSS Animations are still in flux. The Working Group has [decided to provide](http://www.w3.org/2012/01/13-svg-minutes.html#action02) a universal animation spec that would work across CSS, SVG and HTML. For now, either use animations only to provide non-essential aesthetic enhancements or use feature detection to provide an alternative experience for browsers that do not support this feature.
View
@@ -4,4 +4,4 @@ tags: fallback prefixes
kind: css
polyfillurls:
-Make sure to use all the right prefixes (`-o-`, `-webkit-`, `-ms-`, `-moz-`). Additionally, [border-image.com](http://border-image.com/) may help. You should let this fallback to either a normal solid border or no border at all, depending on whether a border is essential for readability. We recommend that you avoid polyfills.
+Make sure to use all the right prefixes (`-o-`, `-webkit-`, `-ms-`, `-moz-`). Additionally, [border-image.com](http://border-image.com/) may help. You should let this fall back to either a normal solid border or no border at all, depending on whether a border is essential for readability. We recommend that you avoid polyfills.
View
@@ -4,4 +4,4 @@ tags: fallback prefixes gtie7
kind: css
polyfillurls:
-<a href="http://css-tricks.com/box-sizing/">`box-sizing`</a>`: border-box` may be a much more sensible default for you. You can apply it to all (`*`) elements if you like. Firefox is the only browser that requires a prefix for box-sizing. You can use it without a prefix for everything else. IE8 has this feature natively and you can optionally use the [box-sizing polyfill](https://github.com/Schepp/box-sizing-polyfill) to provide this feature in IE 6/7 (you could scope the adjustments using [IE conditionals](http://paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/) or Modernizr's <a href="http://www.modernizr.com/download/#-cssclasses-addtest-css_boxsizing">`no-box-sizing`</a>).
+<a href="http://css-tricks.com/box-sizing/">`box-sizing`</a>`: border-box` may be a much more sensible default for you. You can apply it to all (`*`) elements if you like. Firefox is the only browser that requires a prefix for box-sizing. You can use it without a prefix for everything else. IE8 has this feature natively, and you can optionally use the [box-sizing polyfill](https://github.com/Schepp/box-sizing-polyfill) to provide this feature in IE 6/7 (you could scope the adjustments using [IE conditionals](http://paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/) or Modernizr's <a href="http://www.modernizr.com/download/#-cssclasses-addtest-css_boxsizing">`no-box-sizing`</a>).
View
@@ -4,4 +4,4 @@ tags: none
kind: css
polyfillurls:
-Internet Explorer and Firefox are the only supporting browsers, which makes using calc() in production tedious given the impact it can have on layout and the consequent breaking of your design on unsupported browsers. We encourage you use it for experimentation, but not yet for any production use.
+Internet Explorer and Firefox are the only supporting browsers, which makes using calc() in production tedious given the impact it can have on layout and the consequent breaking of your design on unsupported browsers. We encourage you to use it for experimentation, but not yet for any production use.
View
@@ -4,6 +4,6 @@ tags: polyfill
kind: html
polyfillurls:[postmessage-proxied-xhr](https://github.com/toolness/postmessage-proxied-xhr/#readme), [flXHR](http://flxhr.flensed.com/) (requires crossdomain.xml), [pmxdr](https://github.com/eligrey/pmxdr) (requires host installed)
-CORS, or cross-origin resource sharing, enables a few things, but most notably cross-domain AJAX. IE8 introduced [XDomainRequest][], so really only IE7 needs help with cross-domain files. Consider the polyfills below or you can fallback to using a [simple proxy](http://benalman.com/projects/php-simple-proxy/).
+CORS, or cross-origin resource sharing, enables a few things, but most notably cross-domain AJAX. IE8 introduced [XDomainRequest][], so really only IE7 needs help with cross-domain files. Consider the polyfills below or you can fall back to using a [simple proxy](http://benalman.com/projects/php-simple-proxy/).
[XDomainRequest]: http://msdn.microsoft.com/en-us/library/ie/cc288060(v=vs.85).aspx
View
@@ -4,4 +4,4 @@ tags: polyfill
kind: html
polyfillurls: [Details](http://mathiasbynens.be/notes/html5-details-jquery), [jquery-details](http://akral.bitbucket.org/details-tag)
-Use the details element if you intend to show a summary which when clicked reveals detailed information. Without any fallback, non-supporting browsers will fall back to displaying the element in the opened state.
+Use the details element if you intend to show a summary which, when clicked, reveals detailed information. Without any fallback, non-supporting browsers will fall back to displaying the element in the opened state.
View
@@ -5,4 +5,4 @@ kind: css
polyfillurls:
moreurl: http://css3clickchart.com/#exclusions
-Exclusions are new and exciting, but again very much in a flux. Active development to get an implementation out is on-going, but again, please avoid using this until there are stable implementations in the wild.
+Exclusions are new and exciting, but very much in flux. Active development to get an implementation out is on-going, but again, please avoid using this until there are stable implementations in the wild.
@@ -4,12 +4,12 @@ tags: gtie8 polyfill
kind: html
polyfillurls: [html5shiv](http://code.google.com/p/html5shiv/), [html5shiv (github)](https://github.com/aFarkas/html5shiv/), [accessifyhtml5.js](https://github.com/yatil/accessifyhtml5.js)
-All current browsers, except Internet Explorer 8 and below, support the use of the new HTML5 elements (e.g., `<header>`, `<footer>`, `<nav>`, `<article>`, `<section>`, etc.). However they aren’t always mapped to accessibility APIs as the [HTML5 spec](http://www.whatwg.org/specs/web-apps/current-work/multipage/elements.html#wai-aria) requires. Currently [only Firefox does this](http://html5accessibility.com/) but other browsers are implementing the accessibility APIs quickly. In the meantime, [Accessifyhtml5.js](https://github.com/yatil/accessifyhtml5.js) maps them correctly.
+All current browsers, except Internet Explorer 8 and below, support the use of the new HTML5 elements (e.g., `<header>`, `<footer>`, `<nav>`, `<article>`, `<section>`, etc.). However, they aren’t always mapped to accessibility APIs as the [HTML5 spec](http://www.whatwg.org/specs/web-apps/current-work/multipage/elements.html#wai-aria) requires. Currently [only Firefox does this](http://html5accessibility.com/), but other browsers are implementing the accessibility APIs quickly. In the meantime, [Accessifyhtml5.js](https://github.com/yatil/accessifyhtml5.js) maps them correctly.
The notes below only apply to Internet Explorer 8 and below:
-The [html5shiv](http://code.google.com/p/html5shiv/) enables you to use the new HTML5 elements in your markup (and Modernizr does the exact same by default).
+The [html5shiv](http://code.google.com/p/html5shiv/) enables you to use the new HTML5 elements in your markup (and Modernizr does the exact same by default).
If you insert any of these new elements later on (via AJAX or templating), the html5shiv will handle this for you (as of v3). [jQuery 1.7](http://blog.jquery.com/2011/11/03/jquery-1-7-released/) has this functionality baked in.
-Lastly, if you need these elements to print correctly, use [html5shiv-printshiv.js](https://github.com/aFarkas/html5shiv/blob/master/src/html5shiv-printshiv.js).
+Lastly, if you need these elements to print correctly, use [html5shiv-printshiv.js](https://github.com/aFarkas/html5shiv/blob/master/src/html5shiv-printshiv.js).
View
@@ -4,6 +4,6 @@ tags: polyfill gtie9
kind: html
polyfillurls: [jscolor](https://github.com/jo/JSColor), [html5widgets](http://www.useragentman.com/blog/2010/07/27/cross-browser-html5-forms-using-modernizr-webforms2-and-html5widgets/)
-Color inputs will fall back to a plain text input if it's not supported, but excluding Opera, no desktop browser has added support for color inputs.
+A color input will fall back to a plain text input if it's not supported, but excluding Opera, no desktop browser has added support for color inputs.
You should probably avoid this until it has support in WebKit, Gecko or IE.
View
@@ -4,8 +4,8 @@ tags: polyfill gtie9
kind: html
polyfillurls: [Input Range Polyfill](http://www.frequency-decoder.com/2010/11/18/unobtrusive-slider-control-html5-input-range-polyfill/), [html5slider](https://github.com/fryn/html5slider)
-Range inputs (AKA sliders) will fall back to a plain text input if it's not supported.
+A range input (AKA slider) will fall back to a plain text input if it's not supported.
You can use freqdec's [Input Range Polyfill](http://www.frequency-decoder.com/2010/11/18/unobtrusive-slider-control-html5-input-range-polyfill/) or for just Firefox support, Frank Yan's [html5slider](https://github.com/fryn/html5slider).
-These polyfills aren't drop-in polyfills and you'll need to wire them up a little, but your markup can depend on `<input type=range>` creating a slider.
+These polyfills aren't drop-in polyfills, and you'll need to wire them up a little, but your markup can depend on `<input type=range>` creating a slider.
View
@@ -4,4 +4,4 @@ tags: gtie7 polyfill
kind: js
polyfillurls: [json2.js](https://github.com/douglascrockford/JSON-js)
-Crockford's [JSON2.js](https://github.com/douglascrockford/JSON-js) is a perfect polyfill, that accounts for non-native implementations (basically only IE6 & IE7 at this point). It's robust, well tested and can be used along with the native feature flawlessly.
+Crockford's [JSON2.js](https://github.com/douglascrockford/JSON-js) is a perfect polyfill that accounts for non-native implementations (basically only IE6 & IE7 at this point). It's robust, well tested and can be used along with the native feature flawlessly.
View
@@ -4,4 +4,4 @@ tags: polyfill
kind: api
polyfillurls:
-matchMedia provides a JavaScript API to see if a media query will succeed. [MatchMedia.js](https://github.com/paulirish/matchMedia.js/) provides a shim for unsupported browsers. If you want a shim that is responsive to window resizing, you can use [this fork](http://www.paulrhayes.com/2011-11/use-css-transitions-to-link-media-queries-and-javascript/), though its limited to browsers that support CSS Transitions.
+matchMedia provides a JavaScript API to see if a media query will succeed. [MatchMedia.js](https://github.com/paulirish/matchMedia.js/) provides a shim for unsupported browsers. If you want a shim that is responsive to window resizing, you can use [this fork](http://www.paulrhayes.com/2011-11/use-css-transitions-to-link-media-queries-and-javascript/), though it's limited to browsers that support CSS Transitions.
View
@@ -4,6 +4,6 @@ tags: prefixes gtie9
kind: css
polyfillurls:
-Internet Explorer (10+), and Opera support CSS Multi-column Layout without vendor prefixes, so you only need prefixed versions for `-webkit-` and `-moz-`. A further note, features like `column-break-after`, `column-break-before`, and `column-break-inside` - which are necessary for advanced typography - are currently WebKit-only.
+Internet Explorer (10+), and Opera support CSS Multi-column Layout without vendor prefixes, so you only need prefixed versions for `-webkit-` and `-moz-`. A further note, features like `column-break-after`, `column-break-before`, and `column-break-inside` which are necessary for advanced typography are currently WebKit-only.
-We recommend you do not polyfill this and let it fall back to single column text.
+We recommend you do not polyfill this and let it fall back to single column text.
View
@@ -4,4 +4,4 @@ tags: fallback gtie9
kind: html
polyfillurls:
-If Application Cache isn't available natively, there is no way to mimic it. Only supporting browser will be able to load a page while offline. Still many apps can make use of local storage enable offline interaction if the page is already open.
+If Application Cache isn't available natively, there is no way to mimic it. Only supporting browser will be able to load a page while offline. Still, many apps can make use of local storage to enable offline interaction if the page is already open.
View
@@ -4,4 +4,4 @@ tags: fallback noie
kind: css
polyfillurls:
-Pointer events are available in SVG and CSS. All modern browsers support them in SVG, but IE and Opera do not support them in CSS yet. There is a [modernizr plugin](https://github.com/Modernizr/Modernizr/feature-detects/pointerevents.js) to detect support which can be used to implement a JavaScript interceptor for elements which require pointer events to be disabled.
+Pointer events are available in SVG and CSS. All modern browsers support them in SVG, but IE and Opera do not support them in CSS yet. There is a [modernizr plugin](https://github.com/Modernizr/Modernizr/feature-detects/pointerevents.js) to detect support, which can be used to implement a JavaScript interceptor for elements which require pointer events to be disabled.
View
@@ -4,4 +4,4 @@ tags: none
kind: css
polyfillurls:
-CSS Regions is in active development. As a result, the syntax is in a flux. A polyfill based on an older syntax exists, but we recommend you hold your horses till this spec sees some stability and 3 or more implementations.
+CSS Regions is in active development. As a result, the syntax is in flux. A polyfill based on an older syntax exists, but we recommend you hold your horses till this spec sees some stability and 3 or more implementations.
View
@@ -4,4 +4,4 @@ tags: fallback
kind: html
polyfillurls: [Cross-browser Ruby](http://www.useragentman.com/blog/2010/10/29/cross-browser-html5-ruby-annotations-using-css/), [basic fallback](http://sideshowbarker.net/2009/11/13/html5-ruby/#comment-3388)
-If you are using Ruby element you dont need a script-based fallback but you can provide a CSS based set of good defaults.
+If you are using the Ruby element you don't need a script-based fallback, but you can provide a CSS-based set of good defaults.
View
@@ -4,15 +4,15 @@ tags: fallback gtie6
kind: css
polyfillurls:
-Most CSS Selectors are supported from IE7 onwards, so you should be safe to use. But do note that, on browsers that do not support these selectors, a whole rule will be detected as invalid if these unsupported selectors are present. For example, in IE6 `#main, p:first-child {}` would be invalid because it is unable to understand `p:first-child`. We strongly recommend you do not try to polyfill this, but if you do need one, you can use [Selectivizr](http://selectivizr.com/).
+Most CSS Selectors are supported from IE7 onwards, so you should be safe to use them. But do note that, on browsers that do not support these selectors, a whole rule will be detected as invalid if these unsupported selectors are present. For example, in IE6 `#main, p:first-child {}` would be invalid because it is unable to understand `p:first-child`. We strongly recommend you do not try to polyfill this, but if you do need one, you can use [Selectivizr](http://selectivizr.com/).
#### When you sunset IE6 support, you can use:
* `tr > td` : Immediate descendant (child) selector.
* `dt + dd` : next sibling selector
* `dt ~ dd` : any following sibling
* `div[attr]` and `img[src$=png]` : Attribute selector (starts with, ends with, contains).
-* `p:first-child`
+* `p:first-child`
* `div:hover` and `:hover` state on all non-`<a>`'s
* `li.food.vegetable` : without worrying about the [chained classes bug](http://paulirish.com/2008/the-two-css-selector-bugs-in-ie6/)
@@ -27,16 +27,16 @@ Most CSS Selectors are supported from IE7 onwards, so you should be safe to use.
* These very useful selectors: <a href="http://css-tricks.com/how-nth-child-works/">`:nth-child(n)`</a>, `:last-child`, `:target`, `:not(s)`, `:enabled`, `:disabled`, `:checked`, `::selection`
* These ones, too: `:root`, `:nth-last-child(n)`, `:nth-of-type(n)`, `:nth-last-of-type(n)`, `:first-of-type`, `:last-of-type`, `:only-child`, `:only-of-type`, `:empty`
-<!--
+<!--
Resources:
* http://coding.smashingmagazine.com/2009/10/14/css-differences-in-internet-explorer-6-7-and-8/
* http://www.bennadel.com/blog/2306-What-CSS-Properties-Are-Supported-When-You-Drop-IE6-Support.htm
* http://analogysoft.com/learning/ui-hulk-out/#beyondie6
-* http://msdn.microsoft.com/en-us/library/cc351024(v=vs.85).aspx#selectors
+* http://msdn.microsoft.com/en-us/library/cc351024(v=vs.85).aspx#selectors
- [].forEach.call( document.querySelectorAll('td'), function(elem){
+ [].forEach.call( document.querySelectorAll('td'), function(elem){
if (elem.innerText.trim() == 'No') elem.style.backgroundColor = 'red';
if (elem.innerText.trim() == 'Yes') elem.style.backgroundColor = 'green';
});
View
@@ -2,8 +2,8 @@ feature: text-shadow
kind: css
status: use
tags: gtie9
-polyfillurls:
+polyfillurls:
-All modern browsers support text-shadow except IE. Since it's mostly used for decorative purposes, we do not recommend using a polyfill, just make sure the text is still legible without a text-shadow. We also advise you to avoid large text-shadows because they can have a negative impact on performance.
+All modern browsers support text-shadow except IE. Since it's mostly used for decorative purposes, we do not recommend using a polyfill; just make sure the text is still legible without a text-shadow. We also advise you to avoid large text-shadows because they can have a negative impact on performance.
Sometimes you may do light/transparent text with an invert text-shadow. In these cases, we recomend to feature detect (with Modernizr) so you can provide solid color `.no-textshadow` fallback styling.
View
@@ -4,4 +4,4 @@ tags: none
kind: css
polyfillurls:
-Text stroke adds an outline or stroke to text and and is only supported by WebKit. Text stroke has never been part of a CSS specification and should be avoided.
+Text stroke, which adds an outline or stroke to text, is only supported by WebKit. Text stroke has never been part of a CSS specification and should be avoided.
View
@@ -4,7 +4,7 @@ tags: polyfill gtie8
kind: html
polyfillurls: [Video.js](http://videojs.com/), [mediaelementjs](http://mediaelementjs.com/)
-Do note you need to supply your video in various formats to cater to all browsers and fallbacks&mdash;[Miro Video Converter](http://www.mirovideoconverter.com/) makes this trivial. H264 and WebM cover all browsers (except Firefox 3.6 which needs Ogg Theora). Use one of the polyfills below or gracefully handle all cases without any scripting as explained by Kroc Camen in [Video for Everybody](http://camendesign.com/code/video_for_everybody).
+Do note you need to supply your video in various formats to cater to all browsers and fallbacks&mdash;[Miro Video Converter](http://www.mirovideoconverter.com/) makes this trivial. H264 and WebM cover all browsers (except Firefox 3.6 which needs Ogg Theora). Use one of the polyfills below or gracefully handle all cases without any scripting, as explained by Kroc Camen in [Video for Everybody](http://camendesign.com/code/video_for_everybody).
-There is also an incredibly useful service called [vid.ly](http://vid.ly) which converts video online into all necessary formats and provides a short url that detects your browser/hardware and sends the correct format. [Archive.org](http://archive.org) also converts MP4 videos uploaded to OGG automatically, same with audio.
+There is also an incredibly useful service called [vid.ly](http://vid.ly) which converts video online into all necessary formats and provides a short url that detects your browser/hardware and sends the correct format. [Archive.org](http://archive.org) also converts MP4 videos uploaded to OGG automatically, and does the same with audio.
Oops, something went wrong.

0 comments on commit 9db7714

Please sign in to comment.