<div dir="ltr"><div style>Hi Jack, writers:</div><div style><br></div><div style>Grub problems are relatively common, and intimidating to the average end user. UEFI compounds these difficulties. While we have solid content on these topics in the Installation Guide, I think it could be updated and organized. Related issues come up often in #fedora, <a href="http://ask.fedoraproject.org">http://ask.fedoraproject.org</a>, mailing lists, and forums. I've put together a change proposal for your review, with the aim of providing information that more directly addresses the users' needs. Here's what I came up while with skimming through the IG:</div>
<div style><br></div><div style>==============================================</div><div style>- Gather notes from other docs members on grub. If anyone has some content stashed away that could be useful, it would be great to use it instead of rewriting.</div>
<div style><br></div><div style>- Build on the section dedicated to manual installation of the bootloader. This will cover:</div><div style>* Booting into rescue mode, via reference to rescue mode section</div><div style>
* Manually setting up a chroot if rescue mode is not available.</div><div style>* Regenerating grub config, ie `grub2-mkcondig` .</div><div style>* Installing grub on BIOS/MBR UEFI systems</div><div style>* Choosing default and next boot selection</div>
<div style>* usage of efibootmgr</div><div style><br></div><div style>. Limit explanations of hand-writing of config files to the existing grub appendix.<br></div><div style><br></div><div style>- In section 9.10.1 - In addition to usage during installation, this section addresses the general definition and purpose of a bootloader. Move the general explanation to the bootloader section, and provide a link to it. Also insert a link to new bootloader section.</div>
<div style><br></div><div style>- Move relevant information, ie regenerating config files, from the troubleshooting section to the new bootloader section and refer to it.</div><div style><br></div><div style>- Update procedurals and examples in the troubleshooting section to make sure they apply to GRUB2 usage and not GRUB legacy, especially with regard to grub prompt usage. Possibly substitute grub prompt usage for a more detailed section of the GRUB appendix.</div>
<div style><br></div><div style>- Provide a description of appending and editing boot arguments. if appending or removing arguments is required, simply state ie 'append "single" to the boot arguments' and refer to this description.</div>
<div style><br></div><div style>- Update the "Installing without media" as needed, with most if not all of the procedure staying instead of substituting with references.</div><div style><br></div><div style>- remove widespread references to grub splash image; we don't ship that by default any longer. Add something about splash images to a grub customization section.</div>
<div style><br></div><div style>- Substitute references to GRUB sections for procedural content in FedUP section as needed. Ensure enough of a high level overview remains in the fedup section that users know how to use the information referenced, but remove exact commands, etc. A lot of this is related to the F17 -> F18 upgrade and change from grub-legacy to grub2-efi, and not as relevant after.</div>
<div style><br></div><div style>- Admonishment that fedup is only for F17-> F18 should read F17 and after, or be removed entirely. Not really in the scope of this proposal, but notable anyway.</div><div style><br></div>
<div style>- Update grub features copy to include support for non-ext2 volumes, or defer list of supported volume types for a dedicated paragraph or section.</div><div style><br></div><div style>-Generally verify the content of the GRUB section as a whole, and make changes if needed.</div>
<div style><br></div><div style>- Update Changing runlevels section to reference new 'appending boot arguments' copy and refer to systemd target list in systemd appendix</div><div style><br></div><div style>- Give a brief but more thorough overview of creating custom boot configurations, including usage and purpose of /etc/grub.d/40_custom and friends</div>
<div style><br></div><div style>- Examine boot-init-shutdown and grub appendix for overlap, leaving boot process info in the former and detailed grub information in the latter.</div><div style><br></div><div style>- Examine rescue mode section and grub appendix for overlap, and removing redundancies and adding references if needed.</div>
<div style><br></div><div style>==================================================</div><div style><br></div><div style>Does this work with your plans for the Guide? I'd like to get your thoughts, and change the plan based on input from you and the group before beginning.</div>
<div style><br></div><div style>Thanks,</div><div style>-- Pete</div><div style><br></div></div>