From 1543e02b4a9caf5c2526ef24e455c56367b42635 Mon Sep 17 00:00:00 2001
From: Jon Rowe <hello@jonrowe.co.uk>
Date: Sat, 6 Mar 2021 10:32:22 +0000
Subject: [PATCH] Docs for version 5.0.0

---
 Changelog.md               | 8 +++++++-
 features/upgrade/README.md | 6 ++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/Changelog.md b/Changelog.md
index 864a7a816b..95e0f19c68 100644
--- a/Changelog.md
+++ b/Changelog.md
@@ -1,9 +1,15 @@
-### Development
+### 5.0.0
 [Full Changelog](https://github.com/rspec/rspec-rails/compare/v4.1.0...main)
 
+Enhancements:
+
 * Support new #file_fixture_path and new fixture test support code. (Jon Rowe, #2398)
 * Support for Rails 6.1. (Benoit Tigeot, Jon Rowe, Phil Pirozhkov, and more #2398)
 
+Breaking Changes:
+
+* Drop support for Rails below 5.2.
+
 ### 4.1.0 / 2021-03-06
 
 Enhancements:
diff --git a/features/upgrade/README.md b/features/upgrade/README.md
index d6d442f564..029861fdd9 100644
--- a/features/upgrade/README.md
+++ b/features/upgrade/README.md
@@ -1,3 +1,9 @@
+# Upgrading from rspec-rails 4.x to version 5
+
+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.
+
+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).
+
 # Upgrading from rspec-rails 3.x to version 4
 
 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.