|
1 |
| -# Upgrading from rspec-rails 5.x to version 6 |
| 1 | +# Upgrading |
| 2 | + |
| 3 | +RSpec Rails versions follow semantic versioning of x.y.z where: |
| 4 | + |
| 5 | +- `x` is a major release containing breaking changes and support changes for Rails. |
| 6 | +- `y` is a minor release which will contain only feature additions and bug fixes. |
| 7 | +- `z` is a patch release which will contain only bug fixes for the minor levels currently supported version of Rails. |
| 8 | + |
| 9 | +On new Rails minor releases we will usually release our own new minor version to support that version, occasionally |
| 10 | +we will release a new major version instead to allow us to remove support for now unsupported versions of Rails |
| 11 | +as defined by the Rails team themselves. |
| 12 | + |
| 13 | +The RSpec team will only maintain the current major / minor version, although it is common for the `main` branch |
| 14 | +to contain changes for the next upcoming version of Rails and usage of this branch directly is also supported. |
2 | 15 |
|
3 |
| -RSpec Rails 6 is a major version under semantic versioning, it also follows our new versioning strategy for RSpec-Rails, which is to keep in step with Rails supported versions. Thus it supports 6.1 and 7.0. There are no changes required to upgrade to RSpec Rails 6 if you are using a supported version of Rails. |
| 16 | +# Upgrading from rspec-rails 6.x to version 7 |
| 17 | + |
| 18 | +RSpec Rails 7 supports Rails versions 7.0, 7.1 and 7.2. There are no changes required to upgrade from 6.x to 7 for these versions of Rails, |
| 19 | +but we encourage those doing multiple step upgrades to upgrade to Rails 7.1 and RSpec Rails 6.1.x before upgrading to Rails 7.2 and RSpec Rails 7.0. |
| 20 | + |
| 21 | +If you are on Rails 6.1 you will need to keep using RSpec Rails 6.1. |
| 22 | + |
| 23 | +# Upgrading from rspec-rails 5.x to version 6 |
4 | 24 |
|
5 |
| -If you are using an older version of Rails, you can use 5.x which hard supports 5.2 and 6.x. |
| 25 | +RSpec Rails 6 supports Rails versions 6.1, 7.0 and 7.1. There are no changes required to upgrade from 5.x to 6 for these versions of Rails. |
6 | 26 |
|
7 | 27 | # Upgrading from rspec-rails 4.x to version 5
|
8 | 28 |
|
9 |
| -RSpec Rails 5 is a major version under semantic versioning, it also follows our new versioning strategy for RSpec-Rails, which is to keep in step with Rails supported versions. Thus it supports 5.2, 6.0 and 6.1. There are no changes required to upgrade to RSpec Rails 5 if you are using a supported version of Rails. |
| 29 | +RSpec Rails 5 supports 5.2, 6.0 and 6.1. There are no changes required to upgrade from 4.x to 5 for these versions of Rails. |
10 | 30 |
|
11 | 31 | If you are using an older version of Rails, you can use 4.x which hard supports 5.0 and 5.1, and soft supports 4.2 (which is unmaintained).
|
12 | 32 |
|
13 | 33 | # Upgrading from rspec-rails 3.x to version 4
|
14 | 34 |
|
15 |
| -RSpec Rails 4 is a major version under semantic versioning, it allowed us to change the supported Rails versions to 5 and 6 only. There are no changes required to upgrade to RSpec Rails 4 if you are using Rails 5 or 6. |
| 35 | +RSpec Rails 4 was the first version to be released out of step with rspec, as a major version under semantic versioning, it allowed us to change the supported Rails versions to 5 and 6 only. |
| 36 | +There are no changes required to upgrade to RSpec Rails 4 from 3.x if you are using Rails 5 or 6. |
16 | 37 |
|
17 | 38 | If you are using Rails 4.2 you can use RSpec Rails 4, but note that support for it is not maintained, we consider this a breaking change hence the version change, and you must be on Ruby 2.2 as a minimum.
|
18 | 39 |
|
|
0 commit comments