On Thu, May 27, 2021 at 2:05 PM Chris Murphy <lists@xxxxxxxxxxxxxxxxx> wrote: > > On Thu, May 27, 2021 at 3:58 AM Mauricio Tavares <raubvogel@xxxxxxxxx> wrote: > > > > On Thu, May 27, 2021 at 5:49 AM e <e@xxxxxxxxxxxxxxxx> wrote: > > > > > > sounds unintuitive, but he just speaks truth to power: > > > > > > https://pagure.io/fedora-docs/quick-docs/issue/352#comment-734630 > > > > > > "I think the GRUB stuff is so esoteric, so conditional and overly complicated, that we shouldn't > > > explain it. Explaining it will take a lot of resources, and then it has to be maintained or it > > > goes stale again. So when in doubt, just say no and don't document it" > > > > > > Then goes on to make a strong argument! > > > > > If you do not like it, don't use it. Campaign your replacement > > of choice and see if you can make it get adopted and grub2 retired. > > Campaigning against it being documented is pushing to have it cancel > > cultured. There is nobody putting a gun on the head of those > > documenting it; it is open source maintained by volunteers. > > This sort of analogy is not helpful at all. That's not what I'm doing. > I'm just giving advice based on my own experience writing books and > articles on super complicated material, and having a fairly good grasp > of GRUB behavior in Fedora, along with many conversations with > Fedora's bootloader team. It's strictly an opinion to fellow doc > writers, to help them assess where to put their own limited resources. > If people want to do it anyway, I wish them a lot of luck because > they're gonna need it. And I did advocate for, made suggestions and tested them, for the recent GRUB2 wiki updates: https://fedoraproject.org/wiki/GRUB_2 In particular the grubby stuff, which works regardless of firmware and release version. So there's less of this "choose your own adventure" type instructions, where you have to know esoteric things like whether your system is BIOS or UEFI, etc. -- Chris Murphy _______________________________________________ devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
