On Sat, 24 May 2025 at 15:01, Justin B Rye <justin.byam....@gmail.com> wrote: > > Richard Lewis wrote: > > Sistemas Jaguar, <sjag...@proton.me> wrote: > >> The title of section 4.2.1 is inconsistent with section 4.2. > >> > >> 4.2 Upgrades from Debian 12 (bookworm) > >> 4.2.1. Upgrade to Debian 12 (bookworm) > >> > >> The use of 'to' here is inconsistent and misleading. > >> > > > > ive always thought this was not great, but the idea is correct: you need to > > properly upgrade to bookworm before you then move off it: you cant skip > > releases. > > Perhaps things would be clearer if we merged 4.2.2 into 4.2.1 - that > is, instead of "Upgrade to Debian 12 (bookworm)" and then "Upgrade to > latest point release" (which doesn't really make sense as a separate > stage), combine the two as > > Start from the latest point release > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > The procedure given here assumes your system has already been > upgraded to the latest point release of Debian |OLDRELEASE| > (|OLDRELEASENAME|); upgrades skipping releases are not supported. > Display your Debian version with: > > .. code-block:: console > > $ cat /etc/debian_version > > If needed, upgrade to Debian |OLDRELEASE| first following the > instructions at |URL-R-N-OLDSTABLE|.
looks good to me - maybe "if needed" should be stronger as you're not supposed to skip a stable release
