Holger Wansing wrote: >> 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.
The only way I'm likely to make any progress towards fixing this bug is by persuading myself I agree with you here! > 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". -- JBR with qualifications in linguistics, experience as a Debian sysadmin, and probably no clue about this particular package