From 13fa8a3dfce18c71dc23bb63aace5bb008122fb8 Mon Sep 17 00:00:00 2001
From: Erin Millard <ezzatron@gmail.com>
Date: Mon, 21 Dec 2020 17:58:11 +1000
Subject: [PATCH] Prepare 5.0.0 release

---
 CHANGELOG.md  | 19 +++++++++++++++++++
 MIGRATING.md  | 14 ++++++++++++++
 composer.json |  2 +-
 3 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f5d39759e..3078f4b68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,24 @@
 # Phony changelog
 
+## 5.0.0 (2020-12-21)
+
+- **[BC BREAK]** PHP 7.2 is no longer supported.
+- **[NEW]** Added support for PHP 8 union types ([#250]).
+- **[NEW]** Added support for PHP 8 `false` types ([#250]).
+- **[NEW]** Added support for PHP 8 `mixed` types ([#250]).
+- **[NEW]** Added support for PHP 8 `static` return types ([#250]).
+- **[NEW]** Added support for `parent` types ([#250]).
+
+### Known issues
+
+- PHP 8 named arguments are not supported.
+- No guarantees are made about which specific value will be returned from a stub
+  (or mock method) with a union return type, when no explicit return value is
+  specified. The value may differ depending on the order in which the union
+  type's members appear.
+
+[#250]: https://github.com/eloquent/phony/issues/250
+
 ## 4.0.1 (2020-08-29)
 
 - **[FIXED]** Nullable variadics can now be mocked ([#248] - thanks [@keksa]).
diff --git a/MIGRATING.md b/MIGRATING.md
index ead03b711..d9779ca8f 100644
--- a/MIGRATING.md
+++ b/MIGRATING.md
@@ -1,5 +1,19 @@
 # Migration guide
 
+## Migrating from `4.x` to `5.x`
+
+The *Phony* `5.x` release drops support for PHP 7.2. If you only need to support
+PHP 7.3 or later, then it is recommended that you upgrade to *Phony* `5.x`. If
+you still need to support PHP 7.2, then you are free to continue using the `4.x`
+version of *Phony*.
+
+## Migrating from `3.x` to `4.x`
+
+The *Phony* `4.x` release drops support for PHP 7.1. If you only need to support
+PHP 7.2 or later, then it is recommended that you upgrade to *Phony* `4.x`. If
+you still need to support PHP 7.1, then you are free to continue using the `3.x`
+version of *Phony*.
+
 ## Migrating from `2.x` to `3.x`
 
 - [The `3.x` release only supports PHP 7.1 or later]
diff --git a/composer.json b/composer.json
index 0456fa43f..2cbc9285e 100644
--- a/composer.json
+++ b/composer.json
@@ -47,7 +47,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "4.1.x-dev"
+            "dev-master": "5.1.x-dev"
         }
     }
 }