docs-qa May 2023

docs-qa@lists.fedoraproject.org

26 discussions

[Bug 2060893] New: Create vision how to handle Perl modules in case of crypto-policies
by bugzilla＠redhat.com 31 May '24

31 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=2060893 Bug ID: 2060893 Summary: Create vision how to handle Perl modules in case of crypto-policies Product: Fedora Documentation Version: devel Status: NEW Component: technical-notes Assignee: pbokoc(a)redhat.com Reporter: mspacek(a)redhat.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: wb8rcr(a)arrl.net, zach(a)oglesby.co Target Milestone: --- Classification: Fedora We have Perl modules in Fedora, which are implementing security algorithms directly (in C or Perl). This mean, that we cannot control functionality by crypto-policies. We need to create some vision how this situation handle. Output should be a document, which describe actual situation and suggests real solutions which fix this situation. -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2060893

1 1

[Bug 1855464] New: how to create and activate swapfiles post-install
by bugzilla＠redhat.com 31 May '24

31 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=1855464 Bug ID: 1855464 Summary: how to create and activate swapfiles post-install Product: Fedora Documentation Version: devel Status: NEW Component: docs-requests Assignee: pbokoc(a)redhat.com Reporter: bugzilla(a)colorremedies.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: nobody(a)fedoraproject.org, sparks(a)redhat.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora This feature means by default there will be no swap partition by default https://fedoraproject.org/wiki/Changes/SwapOnZRAM Some folks might want/need disk based swap. swapfiles: pros: easy to setup; no reboot required; supported on btrfs, ext4, xfs; removable cons: hibernation is sketchy. it should work on ext4, might work on xfs, does not work on btrfs (it can but requires a tool to find an offset, due to the lack of a standard interface across all file systems, for automatically finding the offset) https://lore.kernel.org/linux-btrfs/20200127192548.GA683123@vader/ partition: pros: no limitations cons: takes up space, isn't resizeable; more complicated/risky to create; requires reboot. Notes: The installer's custom partitioning will continue to permit the creation of a swap partition and will configure for hibernation. -- You are receiving this mail because: You are the QA Contact for the bug.

1 2

[Bug 2033158] New: Grub documentation out of date in System Administration Guide
by bugzilla＠redhat.com 21 May '24

21 May '24

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 3

[Bug 1993662] New: In F34 /usr/bin/X process is a wrapper of /usr/libexec/Xorg
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=1993662 Bug ID: 1993662 Summary: In F34 /usr/bin/X process is a wrapper of /usr/libexec/Xorg Product: Fedora Documentation Version: devel Status: NEW Component: system-administrator's-guide Assignee: pbokoc(a)redhat.com Reporter: sinosuse(a)gmail.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: swadeley(a)redhat.com Target Milestone: --- Classification: Fedora Description of problem: https://docs.fedoraproject.org/en-US/fedora/f34/system-administrators-guide… command "ps aux|grep /usr/bin/X" In f34, /usr/bin/X is linked to /usr/bin/Xorg, which is wrapper of /usr/libexec/Xorg. [suse@suse ~]$ ls -altr /usr/bin/X lrwxrwxrwx 1 root root 4 Apr 14 18:58 /usr/bin/X -> Xorg [suse@suse ~]$ ls -altr /usr/bin/Xorg -rwxr-xr-x 1 root root 277 Apr 14 18:55 /usr/bin/Xorg [suse@suse ~]$ cat /usr/bin/Xorg #!/usr/bin/sh # # Execute Xorg.wrap if it exists otherwise execute Xorg directly. # This allows distros to put the suid wrapper in a separate package. basedir=/usr/libexec if [ -x "$basedir"/Xorg.wrap ]; then exec "$basedir"/Xorg.wrap "$@" else exec "$basedir"/Xorg "$@" fi Version-Release number of selected component (if applicable): xorg-x11-server-Xorg-1.20.11-1.fc34.x86_64 How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: suggest to use command "ps aux|grep Xorg" Additional info: -- You are receiving this mail because: You are the QA Contact for the bug.

1 2

[Bug 1831542] New: Documentation of PEERNTP variable
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=1831542 Bug ID: 1831542 Summary: Documentation of PEERNTP variable Product: Fedora Documentation Version: devel Status: NEW Component: system-administrator's-guide Assignee: pbokoc(a)redhat.com Reporter: mlichvar(a)redhat.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: swadeley(a)redhat.com Target Milestone: --- Classification: Fedora Description of problem: The PEERNTP variable, which can be set to "no" in /etc/sysconfig/network in order to disable use of NTP servers provided by the DHCP server, is described in the "Configuring NTP Using ntpd" section, but not in the "Configuring NTP Using the chrony Suite". Both ntp and chrony follow this setting. The documentation should make it clear that NTP servers provided by DHCP are enabled by default. -- You are receiving this mail because: You are the QA Contact for the bug.

1 2

[Bug 1662306] New: TigerVNC Configuration Page out of date
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=1662306 Bug ID: 1662306 Summary: TigerVNC Configuration Page out of date Product: Fedora Documentation Version: devel Hardware: x86_64 OS: Linux Status: NEW Component: system-administrator's-guide Severity: medium Assignee: pbokoc(a)redhat.com Reporter: colin.henry(a)gmail.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: swadeley(a)redhat.com Target Milestone: --- Classification: Fedora Description of problem: Documentation does not reflect current file configuration Version-Release number of selected component (if applicable): Fedora 29 How reproducible: Try and follow the instructions on the configuration page, it tells you to change settings that aren't there. For instance, users are told to edit the and change: ExecStart=/sbin/runuser -l USER -c "/usr/bin/vncserver %i -geometry 1280x1024" PIDFile=/home/USER/.vnc/%H%i.pid Whereas the actual file contains: ExecStart=/usr/bin/vncserver -autokill %i PIDFile=/home/<USER>/.vnc/%H%i.pid Steps to Reproduce: 1. Go to the documentation page: https://docs.fedoraproject.org/en-US/fedora/f29/system-administrators-guide… 2. Install tigervnc-server 3. Look at the configuration file /lib/systemd/system/vncserver@.service Actual results: The files differ significantly, also following the instructions in the configuration file fails to start vnc successfully, but I'll file a bug for that separately. Expected results: Configuration documentation should match the files on the host Additional info: -- You are receiving this mail because: You are the QA Contact for the bug.

1 1

[Bug 2185155] New: Please list the KDE version bundled with spin
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=2185155 Bug ID: 2185155 Summary: Please list the KDE version bundled with spin Product: Fedora Documentation Version: devel Hardware: All OS: All Status: NEW Component: about-fedora Severity: high Assignee: pbokoc(a)redhat.com Reporter: ddascalescu(a)gmail.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: zach(a)oglesby.co Target Milestone: --- Classification: Fedora # Description of problem I'm at https://spins.fedoraproject.org/kde/, trying to figure out if the bundled version if KDE is higher than that of my distro. I can't tell. Googling "KDE version in Fedora spin" doesn't show anything immediately useful. Why the mystery? Please list the version on that page. If it's a plain to maintain the versions up-to-date, please explain at https://spins.fedoraproject.org/en/ how to figure out the version. Also at https://spins.fedoraproject.org/en/prerelease.html -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2185155

1 1

[Bug 2094692] New: Older release link in the main page has error at Japanese language page
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=2094692 Bug ID: 2094692 Summary: Older release link in the main page has error at Japanese language page Product: Fedora Documentation Version: devel Hardware: x86_64 OS: All Status: NEW Component: homepage Assignee: pbokoc(a)redhat.com Reporter: qqke6wd9k(a)apricot.ocn.ne.jp QA Contact: docs-qa(a)lists.fedoraproject.org CC: dimitris(a)glezos.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora Description of problem: At Japanese translation Page of Doc start page, Only "Older release" is link error. so Page Not Found. Japanese Doc : https://docs.fedoraproject.org/ja/docs/ English-US Doc : https://docs.fedoraproject.org/en-US/docs/ I already reported gitlab Fedora Docs page, but not response, so I report in Bugzilla, https://gitlab.com/fedora/docs/docs-website/pages/-/issues/1 not only Japanese but also fr, de , same link error happened. Version-Release number of selected component (if applicable): How reproducible: every times, Steps to Reproduce: 1. go https://docs.fedoraproject.org/en-US/docs/ 2. change language from English to another non-English kanguage (ja ,fr,de, and so on) 3. click "older release" Actual results: If language is Japanese, the page go https://docs.fedoraproject.org/ja/Fedora/26/html/Release_Notes/index.html this is "page not found" page Expected results: go https://docs.fedoraproject.org/en-US/Fedora/26/html/Release_Notes/index.html Additional info: -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2094692

1 1

[Bug 2037234] New: [getfedora.org] Fedora help menu is not contextual to the current edition
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=2037234 Bug ID: 2037234 Summary: [getfedora.org] Fedora help menu is not contextual to the current edition Product: Fedora Documentation Version: devel Status: NEW Component: homepage Severity: medium Assignee: pbokoc(a)redhat.com Reporter: pprinett(a)redhat.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: dimitris(a)glezos.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora Description of problem: On all pages of getfedora.org I am presented with a blue header bar containing three menus: "Editions", "Help" and "Wiki". Those items are universal in the context of Fedora: when clicking on "Help->Documentation" for example, I am asked to choose from all possible help topics independently of the page I am currently seeing. This behaviour, which is easy to understand on the Fedora home page, can be confusing when I land (say, from a search engine) directly on the page of a specific Fedora edition. For example: upon landing on the Fedora IoT downloads page[1], I might want to check the docs. If I click on "Help->Documentation" (the only apparent link to the docs), I am presented a list of many products to choose from, whereas I expected to navigate in the context of Fedora IoT. Perhaps the problem could be solved by simply adding a "Documentation" link next to "Overview" and "Download" in the gray header bar, which (as opposed to the blue one) is apparently contextual to the specific edition I am seeing. [1]: https://getfedora.org/en/iot/download/ [2]: https://docs.fedoraproject.org/en-US/iot/ -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2037234

1 2

[Bug 2037222] New: [getfedora.org] Fedora IoT download formats are not documented
by bugzilla＠redhat.com 21 May '24

21 May '24

https://bugzilla.redhat.com/show_bug.cgi?id=2037222 Bug ID: 2037222 Summary: [getfedora.org] Fedora IoT download formats are not documented Product: Fedora Documentation Version: devel Status: NEW Component: homepage Severity: medium Assignee: pbokoc(a)redhat.com Reporter: pprinett(a)redhat.com QA Contact: docs-qa(a)lists.fedoraproject.org CC: dimitris(a)glezos.com, zach(a)oglesby.co Target Milestone: --- Classification: Fedora Description of problem: On the Fedora IoT downloads page[1], I am presented with two formats: "Raw Images" versus "Installer ISOs". It is not explained why I would choose one over the other. [1]: https://getfedora.org/en/iot/download/ Version-Release number of selected component (if applicable): Fedora IoT 35 How I got there: 1. I searched 'Fedora iot' in your favourite search engine 2. I landed on 'https://getfedora.org/iot/' 3. I clicked 'Download' in the top right-hand corner of the page Actual results: I am presented the two format options without any explanation Expected results: I am presented the download format that matches the documentation Additional info: In the Fedora IoT documentation[2], neither the words "Raw Image" nor "Installer ISO" seem to be ever mentioned. In both the "Getting Started" sections "Setting up a Virtual Machine" and "Setting up a Physical Device", the command-line examples refer to the downloaded file as `Ferora-IoT-[version].raw.xz` (and not .iso). [2]: https://docs.fedoraproject.org/en-US/iot/ -- You are receiving this mail because: You are the QA Contact for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2037222

1 2

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

docs-qa May 2023