git: d9b67188b5 - main - 15.1: Improve upgrade instructions

The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/doc/commit/?id=d9b67188b5ea2be67e355bb57494d5bceb61bd46

commit d9b67188b5ea2be67e355bb57494d5bceb61bd46
Author:     Lexi Winter <ivy@FreeBSD.org>
AuthorDate: 2026-06-26 07:47:17 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-06-26 07:52:51 +0000

    15.1: Improve upgrade instructions
    
    - Upgrading 14.x pkgbase to 15 is not supported
    - Upgrading pkg to upgrade the base system is not required
    - Third party kmods must only be upgraded if using them
    
    Reported by:            markj (efi case varies, bectl is zfs only)
    Co-authored-by:         Alexander Ziaee <ziaee@FreeBSD.org>
    Differential Revision:  https://reviews.freebsd.org/D57606
---
 website/content/en/releases/15.1R/upgrading.adoc | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/website/content/en/releases/15.1R/upgrading.adoc b/website/content/en/releases/15.1R/upgrading.adoc
index 7588186f71..116d4fb437 100644
--- a/website/content/en/releases/15.1R/upgrading.adoc
+++ b/website/content/en/releases/15.1R/upgrading.adoc
@@ -118,11 +118,11 @@ Continue to <<upgrade-loader-uefi>> or <<upgrade-loader-bios>> below.
 == Upgrading with Base System Packages
 
 Systems deployed with a packaged base system are upgraded via man:pkg[8].
-Systems running {releasePrevLegacy} or {releasePrev} can be upgraded as follows:
+Systems running {releasePrev} can be upgraded as follows:
 
 . **Snapshot the Current Installation**
 +
-Take a recursive snapshot of the functioning system named with the current date:
+If booting from ZFS, take a recursive snapshot of the functioning system named with the current date:
 +
 [source,shell,subs="verbatim,attributes"]
 ----
@@ -131,11 +131,13 @@ bectl create -r pre-{localRel}
 +
 The boot loader offers a menu to boot from this if the upgrade needs to be rolled back.
 +
-. **Upgrade the Package Manager**
+. **Upgrade the Installed System**
++
+Before upgrading to a new release, ensure the installed system is up to date:
 +
 [source,shell]
 ----
-pkg upgrade -yr FreeBSD-ports pkg
+pkg upgrade -r FreeBSD-base
 ----
 +
 . **Upgrade the Base System**
@@ -151,7 +153,7 @@ Follow those instructions as needed.
 +
 . **Upgrade Third‑party Kernel Modules**
 +
-Third party kernel modules must also be upgraded with the base system:
+If third party kernel modules are installed, they must also be upgraded with the base system:
 +
 [source,shell]
 ----
@@ -226,7 +228,7 @@ cp /boot/loader.efi /boot/efi/efi/freebsd/loader.efi
 cp /boot/loader.efi /boot/efi/efi/boot/bootx64.efi
 ----
 +
-Note that some installations may not have `freebsd/loader.efi`.
+Note that some installations may have reversed case (e.g. `EFI/BOOT/BOOTX64.EFI`) or may not have `freebsd/loader.efi`.
 +
 For AArch64 systems, execute the following commands instead:
 +