README.md in bitters-0.9.1 vs README.md in bitters-0.9.2
- old
+ new
@@ -1,53 +1,43 @@
Bitters
===
Add a dash of predefined style to get your [Bourbon](http://bourbon.io) stylesheets started off in the right direction.
-Bitters is meant to help designers get projects started on new projects faster. It adds enough predefined structure and style to get started quickly but bland enough so that it doesn't dictate any style moving forward.
+Bitters is meant to help designers get projects started on new projects faster. It adds enough predefined structure and style to get started quickly but bland enough so that it doesn't dictate any style moving forward. Bitters should live in your projects sass root folder and be **modified** and extended while you design your project.
Install Instructions
===
Install Bitters:
```bash
-gem install Bitters
+gem install bitters
```
-Install [Bourbon](https://github.com/thoughtbot/bourbon#install-for-rails-31) and [Neat](https://github.com/thoughtbot/neat#install-instructions) (optional).
+Install [Bourbon](https://github.com/thoughtbot/bourbon#install-for-rails-31) (required) and [Neat](https://github.com/thoughtbot/neat#install-instructions) (optional).
Then `cd` to your Sass directory and run:
```bash
bitters install
```
The generated folder will contain all Bitters files.
-Import Bitters after Bourbon and Neat in your `application.css.scss`. All additional stylesheets should be imported below Bitters:
+Import Bitters after Bourbon in your `application.css.scss`. If you are using the Neat overrides found in `_grid-settings.scss`, be sure to `@import "bitters/bitters"` between Bourbon and Neat. Be sure to not include any of Neat's mixins or functions in the Bitters files when modifying Bitters. All additional stylesheets should be imported below Bitters:
```scss
@import "bourbon";
-@import "neat";
@import "bitters/bitters";
+@import "neat";
// All other imports
```
+
We suggest using [Normalize](http://necolas.github.io/normalize.css/) for a CSS reset with Bitters.
-If you are using the Neat overrides found in `_grid-settings.scss`, `@import "bitters/grid-settings"` between Bourbon and Neat as directed by [Neats Documentation](https://github.com/thoughtbot/neat#getting-started).
-```scss
-@import "normalize";
-@import "bourbon";
-@import "bitters/grid-settings";
-@import "neat";
-@import "bitters/bitters";
-
-// All other imports
-```
-
Getting Started
===
### Sass structure & default style
The base folder should contain styles for all the basic elements used throughout the sites style. Feel free to add code to the existing files or add new files to customize Bitters for your site.
@@ -80,10 +70,10 @@
Credits
===
![thoughtbot](http://thoughtbot.com/images/tm/logo.png)
-Bourbon is maintained and funded by [thoughtbot, inc](http://thoughtbot.com/community). Tweet your questions or suggestions at [@kylefiedler](https://twitter.com/kylefiedler).
+Bitters is maintained and funded by [thoughtbot, inc](http://thoughtbot.com/community). Tweet your questions or suggestions at [@kylefiedler](https://twitter.com/kylefiedler).
License
===
Bitters is Copyright © 2013 thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.