[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#1069417: upgrade procedure instructs users to run “apt update” but neglects upgrading



Holger Wansing <hwansing@mailbox.org> writes:


>> When following that link, the article says to do an “apt update” then 
>> neglects to tell users to perform the upgrade.
>
> Moreover, we have "This should only be necessary in specific situations." in 
> this chapter appendix A [1], while we recommend to upgrade to the latest point
> release of stable in 4.2.2 [2].
>

> [1] https://www.debian.org/releases/stable/amd64/release-notes/ap-old-stuff.en.html#old-upgrade
> [2] https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.en.html#upgrade-to-latest-point-release

> We should remove that phrase completely.

Agree that makes it better - I think that whole chapter [2] could be
improved.

eg Upgrading to a point release should be in the
main body not hidden in an appendix

eg the bit about debug shells always mystifies me - what would i do if
any of the so-called "basic" checks failed? seems like just linking to a
"how to recover a broken system" at the end would be a better approach?

eg the title "prepare for recovery" section is really unfortunate
-- makes it seem like upgrading debian is going to be somehigh-risk
operation that is likely to go wrong!


every time i upgrade i skim this section and find myself suspecting that
some of the information would be better in a different order, but i
never remember to investigate further


A bit of editing would probably make it both shorter and clearer


Reply to: