From 0050384c0b108ed5e7066da5ff52f54ef88e1f66 Mon Sep 17 00:00:00 2001 From: Nicolas Gallagher Date: Thu, 15 Aug 2013 19:46:33 -0700 Subject: [PATCH] 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. --- README.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 87b60ea..40acfd1 100644 --- a/README.md +++ b/README.md @@ -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