Re: Bug#992034: installation-guide: Include a note on how to change init system during install
- To: Justin B Rye <justin.byam.rye@gmail.com>
- Cc: 992034@bugs.debian.org, debian-l10n-english@lists.debian.org
- Subject: Re: Bug#992034: installation-guide: Include a note on how to change init system during install
- From: Holger Wansing <hwansing@mailbox.org>
- Date: Thu, 9 Sep 2021 19:20:28 +0200
- Message-id: <[🔎] 20210909192028.e359c568e1ce1e2cabd69f83@mailbox.org>
- In-reply-to: <[🔎] YTmn5DGtiLyrAJ8l@jbr.me.uk>
- References: <35C52DA1-5989-4539-97A2-E1569783E436@mailbox.org> <162851979378.27932.17515025153447828917.reportbug@aragorn.weathertop.principate.org.uk> <CANTaovgNqBYn1PNfMsfxkios_kfbihebW+9BbcnN+BBwrZbWGg@mail.gmail.com> <162851979378.27932.17515025153447828917.reportbug@aragorn.weathertop.principate.org.uk> <20210827121911.cf22863fd66af7f4e1a2b8a6@mailbox.org> <162851979378.27932.17515025153447828917.reportbug@aragorn.weathertop.principate.org.uk> <87k0k69g09.fsf@hands.com> <162851979378.27932.17515025153447828917.reportbug@aragorn.weathertop.principate.org.uk> <096E6EAA-DFE8-4BAF-B73A-C2903CCF2978@mailbox.org> <20210908212313.fd228c84feaa5e484f07aa1a@mailbox.org> <[🔎] YTmn5DGtiLyrAJ8l@jbr.me.uk>
Hi,
Justin B Rye <justin.byam.rye@gmail.com> wrote (Thu, 9 Sep 2021 07:21:24 +0100):
> Holger Wansing wrote:
> >> @Justin?
> >
> > Hmm, debian-l10n-english has vanished from the loop somehow.
> > Therefore, I fear you lost track of this thread in the meantime ...
>
> Thanks for spotting that.
>
> > Maybe you could try to catch up starting from
> > https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=992034#90
> > and the follow-ups in the bug and give some feedback?
> > Thanks
>
> In fact I'd also lost track of the fact that this particular thread is
> about changes to the *installer* guide rather than the release notes.
>
> + <sect1 id="misc-adaptions">
> + <title>Miscellaneous adaptions</title>
> +<para>
> +You may make custom adaptions of the installation process, to make it fit
> +your needs:
> +</para>
>
> Another vote against "adaption" (I've heard people use it, but usually
> because they're confusing "adapt" and "adopt"). You've also got an
> odd use of "may", and a slightly clunky repetition of "make" where all
> you really need to say is something like "The installation process can
> be adapted to fit your needs". Except that this doesn't really feel
> to me like a good way to try to fit the section into its context.
>
> Philip Hands suggested the section would fit with its neighbours
> better as
>
> <title>Variations requiring manual intervention</title>
>
> which may be true, but this brings to my attention the point that it
> seems to be promising to list plural variationS whereas in fact we've
> only got this one. Another problem with "manual intervention" is that
> the installer guide tends to use the word "manual" to mean just "less
> automated" - as in "manual" versus "guided" partitioning.
>
> The more I look at the way the sections are organised the more I think
> that the real problem is that "6.3.9 Troubleshooting" is already a
> misfit. There needs to be some clearer mention in 6.1 of the fact
> that jumping to VT2 lets you issue commands behind d-i's back; the
> only place that's explained is the "Troubleshooting" section, which
> has been included in the list of d-i components where it doesn't
> really belong. If that was fixed, maybe there would be a natural
> place to put a section on custom variations in the installation
> process.
>
> It clearly is permitted to promote things out of that list of
> components into separate sections, since after all that's what has
> been done with section 6.4 "Loading Missing Firmware", which has been
> promoted out of 6.3.1 "Setting up Debian Installer and Hardware
> Configuration". So maybe a 6.5 "Troubleshooting and Customization"?
>
> Unfortunately this would necessarily be a long way from the sort of
> minimal patch that people were hoping for...
I'm not that unlucky with the Troubleshooting section, it in fact talks
about existing d-i modules for such job (save-logs, start a shell and
view debug info). And also the ordering of the sections looks more
logically to me that way.
So, I tend to go with a 6.5 section like
+ <sect1 id="customization">
+ <title>Customization</title>
+ <para>
+ The installation process can be further customized to fit your needs:
+ </para>
What do you think?
Holger
--
Holger Wansing <hwansing@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
Reply to: