docs-qa April 2022

docs-qa@lists.fedoraproject.org

3 discussions

[Bug 1952656] New: F33+ "DNF System Upgrade" needs changes.
by bugzilla＠redhat.com 07 Jul '22

07 Jul '22

https://bugzilla.redhat.com/show_bug.cgi?id=1952656 Bug ID: 1952656 Summary: F33+ "DNF System Upgrade" needs changes. Product: Fedora Documentation Version: devel Hardware: x86_64 OS: Linux Status: NEW Component: install-guide Severity: medium Assignee: pbokoc(a)redhat.com Reporter: mattison.computer(a)yahoo.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: pbokoc(a)redhat.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora Description of problem: The F33 (and newer) "DNF System Upgrade" instructions document has a couple of minor issues, and one more serious problem. Version-Release number of selected component (if applicable): Fedora-33, and probably newer. How reproducible: not applicable. Steps to Reproduce: 1. not applicable. 2. not applicable. 3. not applicable. Actual results: not applicable. Expected results: not applicable. Additional info: I. The "Clean-Up Old Packages" Section (2 minor issues). In the "Clean-Up Old Packages" section, the instructions first say to do "sudo dnf repoquery --unsatisfied", and then to do "sudo dnf repoquery --duplicates". After that, there is a "NOTE" box saying to first do "sudo dnf update". After the "NOTE" box, the instructions say to do "sudo dnf list extras", and so on. A. Assuming that the "NOTE" box is saying to do the "sudo dnf update" before doing the "sudo dnf repoquery --unsatisfied" and the "sudo dnf repoquery --duplicates", the box should be moved to between * the "Clean-Up Old Packages" section title, and * the instruction to do "sudo dnf repoquery --unsatisfied". So it should be: 1. The section title "Clean_Up Old Packages"; 2. The "NOTE" box for sudo dnf update"; 3. instruction to run "sudo dnf repoquery --unsatisfied"; 4. instruction to run "sudo dnf repoquery --duplicates"; and 5. instructions to run "sudo dnf list extras", and so on. B. According to the dnf man page, the "update" command is deprecated. It is now "upgrade". So the dnf command in the "NOTE" box discussed above should be "sudo dnf upgrade", not "sudo dnf update". II. The "Clean-Up Old Symlinks" Section (more serious problem). In the Fedora users list, in the thread "invisible application after upgrade", one member said that the "sudo symlinks -r -d /usr" step isn't necessarily a good idea. He provided an example. There was a little more discussion in the Fedora users list thread "dangling symlinks and upgrades (was "invisible application after upgrade").". This section needs to be either redone or deleted. I do not have the expertise to be more specific. I am a home user with no training as a sys.admin. I have a stand-alone home work station. I do my own systems administration. So I rely on the Fedora "DNF System Upgrade" document to guide me through semi-annual upgrades. I ask that this section be researched and either improved or deleted as appropriate. -- You are receiving this mail because: You are the QA Contact for the bug.

1 1

[Bug 2033158] New: Grub documentation out of date in System Administration Guide
by bugzilla＠redhat.com 27 Jun '22

27 Jun '22

https://bugzilla.redhat.com/show_bug.cgi?id=2033158 Bug ID: 2033158 Summary: Grub documentation out of date in System Administration Guide Product: Fedora Documentation Version: devel Status: NEW Component: system-administrator's-guide Assignee: pbokoc(a)redhat.com Reporter: fedora(a)chrisirwin.ca QA Contact: docs-qa(a)lists.fedoraproject.org CC: swadeley(a)redhat.com Target Milestone: --- Classification: Fedora Description of problem: Grub2 documentation is out of date in System Administrators Guide. It explains how grub was configured in previous releases, but doesn't explain the current configuration and tools sufficiently/ * systemd Boot Loader Specification (/boot/loader/entries) * grubby description is inaccurate (it says it edits grub.cfg, while it looks like it now edits /boot/loader/entries/*conf files) * location of grub config (/boot/grub2/grub.cfg, even on EFI systems now) * menuentries in grub.cfg (not used now) * Gives instruction to `grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg` several times, but that is not the proper location now * Above command is given for "Editing a Menu Entry" to change kernel command args, but it doesn't do that any more. grubby must be used for that task. Version-Release number of selected component (if applicable): Fedora 35 Documentation: https://docs.fedoraproject.org/en-US/fedora/f35/system-administrators-guide… Rawhide documentation appears the same. How reproducible: It's documentation, so every time. Steps to Reproduce: 1. Look at Fedora documentation to see where kernel menuentries are defined 2. Documentation says /boot/efi/EFI/fedora/grub.cfg 3. That is not correct. Actual results: 1. /boot/efi/EFI/fedora/grub.cfg is only a stub to load /boot/grub2/grub.cfg, even on EFI systems (documentation says this file is BIOS only) 2. No kernel menu entries are defined there, either 3. Kernel menu entries defined in /boot/loader/entries/*conf files, and probed by grub via unknown mechanism Expected results: Expected documentation to match and explain grub configuration on a current Fedora system. Additional info: -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2033158

1 2

[Bug 1957968] New: WIFI connection with WPS-PBC not working
by bugzilla＠redhat.com 07 Jun '22

07 Jun '22

https://bugzilla.redhat.com/show_bug.cgi?id=1957968 Bug ID: 1957968 Summary: WIFI connection with WPS-PBC not working Product: Fedora Documentation Version: devel Hardware: x86_64 OS: Linux Status: NEW Component: wireless-guide Assignee: pbokoc(a)redhat.com Reporter: hk(a)hsyn.de QA Contact: docs-qa(a)lists.fedoraproject.org CC: sradvan(a)redhat.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora Description of problem: WiFi Connection can't be established with the Fedora 34 via WPS-PBC. Version-Release number of selected component (if applicable): OS: Fedora 34 live USB stick. Rooter: Fritz!Box 7590 v7.27 Notebook: ThinkPad w520 How reproducible: Start Fedora 34 from USB stick. Try to connect to a WPA&WPA2 Secured WiFi. Steps to Reproduce: 1. 2. 3. Actual results: Connection can't established. Expected results: Authentication without manual key enter -- You are receiving this mail because: You are the QA Contact for the bug.

1 3

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

docs-qa April 2022