From 420951eb0e205c8f3f3c42aadd3025673c7e2c89 Mon Sep 17 00:00:00 2001
From: Philippe Delente <philippe.delente@gmail.com>
Date: Fri, 23 May 2025 18:38:25 +0200
Subject: [PATCH] =?UTF-8?q?feat(supported-versions):=20add=20=E2=80=9CNote?=
 =?UTF-8?q?s=E2=80=9D=20column=20with=20upgrade=20guide=20links?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 supported-versions.php | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/supported-versions.php b/supported-versions.php
index a676a094cc..bc08dbba74 100644
--- a/supported-versions.php
+++ b/supported-versions.php
@@ -10,6 +10,10 @@
 // support lifetime, add it under a heading with an anchor, and add the anchor
 // and branch names to the array below ('x.y' => '#anchor-name').
 $VERSION_NOTES = [
+	'8.4' => 'https://www.php.net/manual/migration84.php',
+	'8.3' => 'https://www.php.net/manual/migration83.php',
+	'8.2' => 'https://www.php.net/manual/migration82.php',
+	'8.1' => 'https://www.php.net/manual/migration81.php',
 ];
 ?>
 
@@ -43,6 +47,7 @@
 			<th colspan="2">Initial Release</th>
 			<th colspan="2">Active Support Until</th>
 			<th colspan="2">Security Support Until</th>
+			<th colspan="2">Notes</th>
 		</tr>
 	</thead>
 	<tbody>
@@ -59,9 +64,6 @@
 				<tr class="<?php echo $state ?>">
 					<td>
 						<a href="/downloads.php#v<?php echo htmlspecialchars($release['version']) ?>"><?php echo htmlspecialchars($branch) ?></a>
-						<?php if (isset($VERSION_NOTES[$branch])): ?>
-							<a class="version-notes" href="<?php echo htmlspecialchars($VERSION_NOTES[$branch]) ?>">*</a>
-						<?php endif ?>
 					</td>
 					<td><?php echo htmlspecialchars($initial->format('j M Y')) ?></td>
 					<td class="collapse-phone"><em><?php echo htmlspecialchars(format_interval($initial, $now)) ?></em></td>
@@ -69,6 +71,15 @@
 					<td class="collapse-phone"><em><?php echo htmlspecialchars(format_interval($until, $now)) ?></em></td>
 					<td><?php echo htmlspecialchars($eol->format('j M Y')) ?></td>
 					<td class="collapse-phone"><em><?php echo htmlspecialchars(format_interval($eol, $now)) ?></em></td>
+					<td>
+						<?php if (isset($VERSION_NOTES[$branch])): ?>
+							<a href="<?php echo htmlspecialchars($VERSION_NOTES[$branch]) ?>">
+								Migration guide for PHP <?php echo htmlspecialchars($branch) ?>
+							</a>
+						<?php else: ?>
+							 —
+						<?php endif; ?>
+					</td>
 				</tr>
 			<?php endforeach ?>
 		<?php endforeach ?>