Bug 275301

Summary: 14.0 relnotes lack bios bootloader upgrade warning
Product: Documentation Reporter: Andrew Davis <freebsd>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Many People CC: ale
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Andrew Davis 2023-11-24 10:05:28 UTC
The 14.0 release notes specifically call out if you have an EFI system then you must reinstall the bootloader before running `zpool upgrade`

> Note for systems that boot via EFI
> [...]
>  After a system upgrade, but before doing a zpool upgrade, the boot loader on the ESP must be updated, or the system may become unbootable

They neglect to mention you must reinstall the boot loader when booting in traditional BIOS mode.  The mention of one without the other may lead to people making an incorrect assumption that it is not necessary on the other.  

Suggestion is make a more generalised warning that updating the boot loader is required regardless of whether you boot BIOS or EFI.
Comment 1 Alex Dupre freebsd_committer freebsd_triage 2023-11-29 11:36:12 UTC
WIP: https://reviews.freebsd.org/D42789