Skip to content

Commit 4dd9521

Browse files
committed
Rewrite upgrade notes
1 parent 7d692b1 commit 4dd9521

File tree

1 file changed

+26
-5
lines changed

1 file changed

+26
-5
lines changed

features/upgrade/README.md

+26-5
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,39 @@
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.
215

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
424

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.
626

727
# Upgrading from rspec-rails 4.x to version 5
828

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.
1030

1131
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).
1232

1333
# Upgrading from rspec-rails 3.x to version 4
1434

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.
1637

1738
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.
1839

0 commit comments

Comments
 (0)