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.
This commit is contained in:
Nicolas Gallagher 2013-08-15 19:46:33 -07:00
parent 77982e20d8
commit 0050384c0b

View File

@ -1,14 +1,14 @@
# normalize.css v2
Normalize.css is a customisable CSS file that makes browsers render all
elements more consistently and in line with modern standards. We researched the
differences between default browser styles in order to precisely target only
the styles that need normalizing.
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.
[Check out the demo](http://necolas.github.io/normalize.css/latest/test.html)
[Legacy browser support is available in v1](https://github.com/necolas/normalize.css/tree/v1)
## Install
Download from the [project page](http://necolas.github.io/normalize.css/).
@ -25,11 +25,10 @@ Install with [Bower](http://bower.io/): `bower install --save normalize-css`
## How to use it
Normalize.css is intended to be used as an alternative to CSS resets.
No other styles should come before Normalize.css.
It's suggested that you read the `normalize.css` file and consider customising
it to meet your needs. Alternatively, include the file in your project and
override the defaults later in your CSS.
It is recommended that you include the `normalize.css` file as untouched
library code.
## Browser support
@ -39,7 +38,11 @@ override the defaults later in your CSS.
* Opera 12+
* Internet Explorer 8+
## Contribute
[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