From d05311a296b6237dbe897df48574f6197968457d Mon Sep 17 00:00:00 2001
From: Basil Suter <git@nadar.io>
Date: Tue, 11 Feb 2025 10:10:57 +0000
Subject: [PATCH] Update UPGRADE.md for clarity and formatting improvements

---
 UPGRADE.md | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/UPGRADE.md b/UPGRADE.md
index 7dded15..0453001 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -1,7 +1,10 @@
-This document will help you upgrading from a Version into another.
+This document will guide you through upgrading from one version to another.
 
-# 2.x to 3.0
+# Upgrading from 2.x to 3.0
 
-+ Raised minimum PHP version to 8.x
-+ Added php `json` extensions are required in composer defintion
-+ Removed deprecated methods `_exec()` use `exec()`, `setReferrer()` use `setReferer()` and `verbose()` use `setVerbose()`
\ No newline at end of file
++ **Raised minimum PHP version** to 8.x.  
++ **Added the `json` extension** to Composer requirements, as formatting payloads to JSON is a common use case.  
++ **Removed deprecated methods**:  
+  - `_exec()` → Use `exec()`  
+  - `setReferrer()` → Use `setReferer()`  
+  - `verbose()` → Use `setVerbose()`  
\ No newline at end of file