README.md in bootstrap-sass-2.1.1.0 vs README.md in bootstrap-sass-2.2.1.0

- old
+ new

@@ -10,12 +10,12 @@ ### Rails In your Gemfile: - gem 'sass-rails', '~> 3.1' - gem 'bootstrap-sass', '~> 2.1.1.0' + gem 'sass-rails', '~> 3.2' + gem 'bootstrap-sass', '~> 2.2.1.0' #### CSS Import "bootstrap" in your SCSS file of choice to get all of Bootstrap's styles, mixins and variables! We recommend against using `//= require` directives, since none of your other stylesheets will be [able to use](https://github.com/thomas-mcdonald/bootstrap-sass/issues/79#issuecomment-4428595) the awesome mixins that Bootstrap has defined. @@ -86,16 +86,18 @@ ### Responsive styling? As per the Bootstrap project we don't include the responsive styles by default. `@import "bootstrap-responsive";` to get them. ## Versioning -Bootstrap [claims](https://github.com/twitter/bootstrap#versioning) to use SemVer, although this is for values of public API that don't seem to include selectively requiring CSS components (see breaking change 2.0.2 -> 2.0.3). Since many people using bootstrap-sass *do* selectively require CSS components and I consider it part of the public API we can't really follow SemVer without becoming wildly out of sync with the Bootstrap version number, which is confusing for everyone involved. Further releases to bootstrap-sass will therefore have version numbers of the form `2.x.x.y`, where `2.x.x` is the release of Bootstrap we should be compatible with, and `y` is the patch version. +Bootstrap [claims](https://github.com/twitter/bootstrap#versioning) to use SemVer, although this is for values of public API that don't seem to include selectively requiring CSS components (see breaking change 2.0.2 -> 2.0.3). Since many people using bootstrap-sass *do* selectively require CSS components and I consider it part of the public API we can't really follow SemVer without becoming wildly out of sync with the Bootstrap version number, which is confusing for everyone involved. Further releases to bootstrap-sass will therefore have version numbers of the form `2.x.y.z`, where `2.x.y` is the release of Bootstrap we should be compatible with, and `y` is the patch version. +Basically this means you should expect to append a separate patch version to the bootstrap version, which allows our versioning to stay more honest about changes. + ### Bundler? - gem 'bootstrap-sass', '~> 2.1.1.0' + gem 'bootstrap-sass', '~> 2.2.1.0' -Don't use the standard `~> 2.1.x`. Your apps may break. +Don't use the standard `~> 2.x.y`. Your apps may break. ## Who bootstrap-sass is a project by [Thomas McDonald](https://twitter.com/#!/thomasmcdonald_), with support from [other awesome people](https://github.com/thomas-mcdonald/bootstrap-sass/graphs/contributors). ## You're in good company \ No newline at end of file