Skip to content

Commit b2c19b9

Browse files
committed
Update docs for 8.0
1 parent 6bcb75f commit b2c19b9

File tree

1 file changed

+28
-25
lines changed

1 file changed

+28
-25
lines changed

README.md

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ detailed explanations of how the application is supposed to behave,
99
expressed in plain English.
1010

1111
According to [RSpec Rails new versioning strategy][] use:
12+
* **[`rspec-rails` 8.x][]** for Rails 8.0 or 7.2.
1213
* **[`rspec-rails` 7.x][]** for Rails 7.x.
1314
* **[`rspec-rails` 6.x][]** for Rails 6.1, 7.0 or 7.1.
1415
* **[`rspec-rails` 5.x][]** for Rails 5.2 or 6.x.
@@ -28,20 +29,22 @@ According to [RSpec Rails new versioning strategy][] use:
2829
[`rspec-rails` 5.x]: https://github.com/rspec/rspec-rails/tree/5-1-maintenance
2930
[`rspec-rails` 6.x]: https://github.com/rspec/rspec-rails/tree/6-1-maintenance
3031
[`rspec-rails` 7.x]: https://github.com/rspec/rspec-rails/tree/7-1-maintenance
32+
[`rspec-rails` 8.x]: https://github.com/rspec/rspec-rails/tree/8-0-maintenance
3133
[RSpec Rails new versioning strategy]: https://github.com/rspec/rspec-rails/blob/main/rfcs/versioning-strategy.md
3234

3335
## Installation
3436

35-
**IMPORTANT** This README / branch refers to the current development build.
36-
See the [`7-1-maintenance` branch on Github](https://github.com/rspec/rspec-rails/tree/7-1-maintenance) if you want or require the latest stable release.
37+
**IMPORTANT** This README / branch refers to the 8.0.x stable release series, only bugfixes from this series will
38+
be added here. See the [`main` branch on Github](https://github.com/rspec/rspec-rails/tree/main) if you want or
39+
require the latest unstable features.https://github.com/rspec/rspec-rails/tree/8-0-maintenance) if you want or require the latest stable release.
3740

3841
1. Add `rspec-rails` to **both** the `:development` and `:test` groups
3942
of your app’s `Gemfile`:
4043

4144
```ruby
4245
# Run against this stable release
4346
group :development, :test do
44-
gem 'rspec-rails', '~> 7.0.0'
47+
gem 'rspec-rails', '~> 8.0.0'
4548
end
4649

4750
# Or, run against the main branch
@@ -85,7 +88,7 @@ read the [`rspec-rails` upgrade notes][] to find out what to watch out for.
8588

8689
Be sure to check the general [RSpec upgrade notes][] as well.
8790

88-
[`rspec-rails` upgrade notes]: https://rspec.info/features/7-1/rspec-rails/upgrade
91+
[`rspec-rails` upgrade notes]: https://rspec.info/features/8-0/rspec-rails/upgrade
8992
[RSpec upgrade notes]: https://rspec.info/upgrading-from-rspec-2/
9093

9194
## Usage
@@ -207,22 +210,22 @@ to test the various parts of a Rails system:
207210
Follow the links above for examples of how each matcher is used.
208211

209212
[the matchers that come standard in RSpec]: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers
210-
[`be_a_new`]: https://rspec.info/features/7-1/rspec-rails/matchers/new-record-matcher
211-
[`render_template`]: https://rspec.info/features/7-1/rspec-rails/matchers/render-template-matcher
212-
[`redirect_to`]: https://rspec.info/features/7-1/rspec-rails/matchers/redirect-to-matcher
213-
[`route_to`]: https://rspec.info/features/7-1/rspec-rails/routing-specs/route-to-matcher
214-
[`be_routable`]: https://rspec.info/features/7-1/rspec-rails/routing-specs/be-routable-matcher
215-
[`have_http_status`]: https://rspec.info/features/7-1/rspec-rails/matchers/have-http-status-matcher
216-
[`match_array`]: https://rspec.info/features/7-1/rspec-rails/matchers/relation-match-array
217-
[`have_been_enqueued`]: https://rspec.info/features/7-1/rspec-rails/matchers/have-been-enqueued-matcher
218-
[`have_enqueued_job`]: https://rspec.info/features/7-1/rspec-rails/matchers/have-enqueued-job-matcher
213+
[`be_a_new`]: https://rspec.info/features/8-0/rspec-rails/matchers/new-record-matcher
214+
[`render_template`]: https://rspec.info/features/8-0/rspec-rails/matchers/render-template-matcher
215+
[`redirect_to`]: https://rspec.info/features/8-0/rspec-rails/matchers/redirect-to-matcher
216+
[`route_to`]: https://rspec.info/features/8-0/rspec-rails/routing-specs/route-to-matcher
217+
[`be_routable`]: https://rspec.info/features/8-0/rspec-rails/routing-specs/be-routable-matcher
218+
[`have_http_status`]: https://rspec.info/features/8-0/rspec-rails/matchers/have-http-status-matcher
219+
[`match_array`]: https://rspec.info/features/8-0/rspec-rails/matchers/relation-match-array
220+
[`have_been_enqueued`]: https://rspec.info/features/8-0/rspec-rails/matchers/have-been-enqueued-matcher
221+
[`have_enqueued_job`]: https://rspec.info/features/8-0/rspec-rails/matchers/have-enqueued-job-matcher
219222

220223
### What else does RSpec Rails add?
221224

222225
For a comprehensive look at RSpec Rails’ features,
223226
read the [official Cucumber documentation][].
224227

225-
[official Cucumber documentation]: https://rspec.info/features/7-1/rspec-rails
228+
[official Cucumber documentation]: https://rspec.info/features/8-0/rspec-rails
226229

227230
## What tests should I write?
228231

@@ -267,20 +270,20 @@ RSpec.describe User, type: :model do
267270
...
268271
```
269272

270-
[request]: https://rspec.info/features/7-1/rspec-rails/request-specs/request-spec
271-
[feature]: https://rspec.info/features/7-1/rspec-rails/feature-specs/feature-spec
272-
[system]: https://rspec.info/features/7-1/rspec-rails/system-specs/system-specs
273-
[model]: https://rspec.info/features/7-1/rspec-rails/model-specs
274-
[controller]: https://rspec.info/features/7-1/rspec-rails/controller-specs
275-
[mailer]: https://rspec.info/features/7-1/rspec-rails/mailer-specs
276-
[job]: https://rspec.info/features/7-1/rspec-rails/job-specs/job-spec
277-
[view]: https://rspec.info/features/7-1/rspec-rails/view-specs/view-spec
278-
[routing]: https://rspec.info/features/7-1/rspec-rails/routing-specs
279-
[helper]: https://rspec.info/features/7-1/rspec-rails/helper-specs/helper-spec
273+
[request]: https://rspec.info/features/8-0/rspec-rails/request-specs/request-spec
274+
[feature]: https://rspec.info/features/8-0/rspec-rails/feature-specs/feature-spec
275+
[system]: https://rspec.info/features/8-0/rspec-rails/system-specs/system-specs
276+
[model]: https://rspec.info/features/8-0/rspec-rails/model-specs
277+
[controller]: https://rspec.info/features/8-0/rspec-rails/controller-specs
278+
[mailer]: https://rspec.info/features/8-0/rspec-rails/mailer-specs
279+
[job]: https://rspec.info/features/8-0/rspec-rails/job-specs/job-spec
280+
[view]: https://rspec.info/features/8-0/rspec-rails/view-specs/view-spec
281+
[routing]: https://rspec.info/features/8-0/rspec-rails/routing-specs
282+
[helper]: https://rspec.info/features/8-0/rspec-rails/helper-specs/helper-spec
280283
[`ActionDispatch::IntegrationTest`]: https://api.rubyonrails.org/classes/ActionDispatch/IntegrationTest.html
281284
[`ActionDispatch::SystemTestCase`]: https://api.rubyonrails.org/classes/ActionDispatch/SystemTestCase.html
282285
[`ActionController::TestCase`]: https://api.rubyonrails.org/classes/ActionController/TestCase.html
283-
[in the appropriate folder]: https://rspec.info/features/7-1/rspec-rails/directory-structure
286+
[in the appropriate folder]: https://rspec.info/features/8-0/rspec-rails/directory-structure
284287

285288
### System specs, feature specs, request specs–what’s the difference?
286289

0 commit comments

Comments
 (0)