Hi, Justin B Rye <justin.byam....@gmail.com> wrote (Thu, 9 Sep 2021 21:52:44 +0100): > > 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? > > It might work. Then it goes on: > > <sect2><title>Installing an alternative init system</title> > <para> > &debian; uses systemd as its default init system. However, other > init systems (such as sysvinit and OpenRC) are supported, and the > easiest time to select an alternative init system is during the > installation process. For detailed instructions on how to do so, > please see the > <ulink > url="https://wiki.debian.org/Init#Changing_the_init_system_-_at_installation_time">Init > page on the Debian wiki</ulink>. > </para> > </sect2> > </sect1> > > Hmm. That may have been boiled down *too* far, since there's no > hint that it works by going to a shell. So maybe that should have > been in the intro? (Sorry, can't remember the ulink syntax) > > As well as troubleshooting, the [[6.3.9.2|link]] also allows > further customization of the installation process to fit your > needs: > > People might also want some echo of the Troubleshooting section's > cautionary note wedged in there; the minimal version would be to say > something like "careful customization" and/or "in exceptional cases".
Trying to integrate your suggestions, would then have + <sect1 id="customization"> + <title>Customization</title> + <para> + Using the shell (see <xref linkend="shell"/>), the installation process + can be carefully customized, to fit exceptional use cases: + </para> + + <sect2><title>Installing an alternative init system</title> + <para> + &debian; uses systemd as its default init system. However, other init + systems (such as sysvinit and OpenRC) are supported, and the + easiest time to select an alternative init system is during the + installation process. For detailed instructions on how to do so, + please see the <ulink + url="https://wiki.debian.org/Init#Changing_the_init_system_-_at_installation_time">Init + page on the Debian wiki</ulink>. + </para> + + </sect2> + </sect1> Comments? Holger -- Holger Wansing <hwans...@mailbox.org> PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076