normalize.css/README.md

# normalize.css v2

Normalize.css is a customisable CSS file that makes browsers render all
elements more consistently and in line with modern standards.

The project relies on researching the differences between default browser
styles in order to precisely target only the styles that need or benefit from
normalizing.

[View the test file](http://necolas.github.io/normalize.css/latest/test.html)

## Install

Download from the [project page](http://necolas.github.io/normalize.css/).

Install with [Bower](http://bower.io/): `bower install --save normalize-css`

Install with [Component(1)](http://component.io/): `component install necolas/normalize.css`

## What does it do?

* Preserves useful defaults, unlike many CSS resets.
* Normalizes styles for a wide range of elements.
* Corrects bugs and common browser inconsistencies.
* Improves usability with subtle improvements.
* Explains what code does using detailed comments.

## How to use it

No other styles should come before Normalize.css.

It is recommended that you include the `normalize.css` file as untouched
library code.

## Browser support

* Google Chrome (latest)
* Mozilla Firefox (latest)
* Mozilla Firefox 4
* Opera (latest)
* Apple Safari 6+
* Internet Explorer 8+

[Normalize.css v1 provides legacy browser
support](https://github.com/necolas/normalize.css/tree/v1) (IE 6+, Safari 4+),
but is no longer actively developed.

## Contributing

Please read the CONTRIBUTING.md

## Acknowledgements

Normalize.css is a project by [Nicolas Gallagher](https://github.com/necolas),
co-created with [Jonathan Neal](https://github.com/jonathantneal).
v2.1.2 2013-05-11 20:59:52 +00:00			`# normalize.css v2`
First README.md 2011-04-28 05:56:02 +00:00
Minor copy and comment adjustments 2012-07-08 22:43:00 +00:00			`Normalize.css is a customisable CSS file that makes browsers render all`
README: change guidance and demphasise v1 * Recommend that normalize.css is used as library code (i.e., not modified). * Add a note that v1 is no longer actively developed. 2013-08-16 02:46:33 +00:00			`elements more consistently and in line with modern standards.`
First README.md 2011-04-28 05:56:02 +00:00
README: change guidance and demphasise v1 * Recommend that normalize.css is used as library code (i.e., not modified). * Add a note that v1 is no longer actively developed. 2013-08-16 02:46:33 +00:00			`The project relies on researching the differences between default browser`
			`styles in order to precisely target only the styles that need or benefit from`
			`normalizing.`
First README.md 2011-04-28 05:56:02 +00:00
Update browser support 2014-01-26 04:53:05 +00:00			`[View the test file](http://necolas.github.io/normalize.css/latest/test.html)`
Add Bower install and more to README * Mention v1's support for legacy browsers. * Provide link to project page for easy download. * Include Bower install command. 2013-03-27 22:53:30 +00:00
			`## Install`

Change gh-page URLs to use `.io` GitHub have redirected all `username.github.com` pages to `username.github.io`. 2013-04-05 19:51:36 +00:00			`Download from the [project page](http://necolas.github.io/normalize.css/).`
Add Bower install and more to README * Mention v1's support for legacy browsers. * Provide link to project page for easy download. * Include Bower install command. 2013-03-27 22:53:30 +00:00
Change the Bower website URL 2013-04-22 03:17:09 +00:00			Install with [Bower](http://bower.io/): `bower install --save normalize-css`
Add Bower install and more to README * Mention v1's support for legacy browsers. * Provide link to project page for easy download. * Include Bower install command. 2013-03-27 22:53:30 +00:00
Add Component(1) install instructions 2013-08-16 04:52:25 +00:00			Install with [Component(1)](http://component.io/): `component install necolas/normalize.css`

Add MIT License 2012-08-07 21:27:32 +00:00			`## What does it do?`
Update README with more details and link to demo 2011-06-21 01:06:55 +00:00
			`* Preserves useful defaults, unlike many CSS resets.`
			`* Normalizes styles for a wide range of elements.`
			`* Corrects bugs and common browser inconsistencies.`
			`* Improves usability with subtle improvements.`
			`* Explains what code does using detailed comments.`

Add MIT License 2012-08-07 21:27:32 +00:00			`## How to use it`
Update README with more details and link to demo 2011-06-21 01:06:55 +00:00
README: change guidance and demphasise v1 * Recommend that normalize.css is used as library code (i.e., not modified). * Add a note that v1 is no longer actively developed. 2013-08-16 02:46:33 +00:00			`No other styles should come before Normalize.css.`
Edit README to say normalize should be used as an alternative to resets. Close #39 2011-09-14 10:37:24 +00:00
README: change guidance and demphasise v1 * Recommend that normalize.css is used as library code (i.e., not modified). * Add a note that v1 is no longer actively developed. 2013-08-16 02:46:33 +00:00			It is recommended that you include the `normalize.css` file as untouched
			`library code.`
Link to a YUI Compressor-based minification tool in README. Close #4 2011-08-11 16:44:14 +00:00
Add MIT License 2012-08-07 21:27:32 +00:00			`## Browser support`
First README.md 2011-04-28 05:56:02 +00:00
Update browser support 2014-01-26 04:53:05 +00:00			`* Google Chrome (latest)`
			`* Mozilla Firefox (latest)`
			`* Mozilla Firefox 4`
			`* Opera (latest)`
			`* Apple Safari 6+`
Drop legacy browser support No longer supports IE 6/7, Firefox < 4, and Safari < 5. * Make use of `inherit` to simplify some of the rules. * Remove a lot of padding and margin normalization, particularly for typographic elements, because modern browsers share common base styles. * Add `quotes` normalization. While all target browsers support `quotes`, they don't share a common set of quote styles. Opera and IE use "curly" quotes whereas other browsers do not. Browsers don't appear to set different quotes depending on the language (via the `lang` attribute) of the content. * Remove all list normalizations and they aren't needed anymore. * Remove a handful of form normalizations that targetted IE 6/7 or Firefox 3. 2012-08-16 21:34:39 +00:00			`* Internet Explorer 8+`
Update 2011-04-28 16:57:14 +00:00
README: change guidance and demphasise v1 * Recommend that normalize.css is used as library code (i.e., not modified). * Add a note that v1 is no longer actively developed. 2013-08-16 02:46:33 +00:00			`[Normalize.css v1 provides legacy browser`
			`support](https://github.com/necolas/normalize.css/tree/v1) (IE 6+, Safari 4+),`
			`but is no longer actively developed.`

			`## Contributing`
Update README with link to 'contribute' wiki 2012-04-10 22:59:06 +00:00
Add contribution guidelines Includes process for maintainers while there is no automation in place. Close gh-175 2013-03-29 03:30:19 +00:00			`Please read the CONTRIBUTING.md`
Update README with link to 'contribute' wiki 2012-04-10 22:59:06 +00:00
Add MIT License 2012-08-07 21:27:32 +00:00			`## Acknowledgements`
Update 2011-04-28 16:57:14 +00:00
Update README acknowledgements 2013-01-21 01:34:29 +00:00			`Normalize.css is a project by [Nicolas Gallagher](https://github.com/necolas),`
			`co-created with [Jonathan Neal](https://github.com/jonathantneal).`