New commit to reflect changes required

Signed-off-by: Hank Lee <allegrovelo@gmail.com>

modules/ROOT/nav.adoc

@@ -128,7 +128,8 @@
 ** xref:troubleshooting-bluetooth-problems.adoc[Troubleshooting Bluetooth problems] 
 ** xref:troubleshooting-java-programs.adoc[Troubleshooting Java Programs] 
 ** xref:troubleshooting-mozilla-products.adoc[Troubleshooting Mozilla Products] 
-** xref:troubleshooting-wayland-problems.adoc[Troubleshooting Wayland Problems] 
+** xref:troubleshooting-wayland-problems.adoc[Troubleshooting Wayland Problems]
+** xref:how-to-troubleshoot-sound-problems.adoc[Troubleshooting Sound Problems]
 
 * FAQ
 ** xref:fedora-and-red-hat-enterprise-linux.adoc[Fedora and Red Hat Enterprise Linux]

modules/ROOT/pages/how-to-troubleshoot-sound-problems.adoc

@@ -0,0 +1,142 @@
+= How to troubleshoot sound problems
+Hank Lee ; The Music & Audio SIG
+:revnumber: F40
+:revdate: 2024-07-29
+:category: Administration
+:tags: Troubleshooting, Sound, Multimedia
+
+[abstract]
+This page covers some basic troubleshooting techniques to help narrow down the root cause of an issue. It also explains information that should be included when filing bugs related to sound. General sound problems - where the problem is observed across multiple applications - should usually be filed against the kernel, or PipeWire (see below for instructions on determining whether the problem is PipeWire-related). If the problem is observed only in a specific application, or only in applications which use a single multimedia library (such as SDL or OpenAL), the bug should be filed against that component.
+
+== Check which Kernel driver is in use by PCI devices
+
+To display kernel drivers handling each device, use the lspci (List PCI) command with the option -k. Searching for known issues specific to driver’s name and your hardware model before reporting issues to Ask Fedora.
+
+[source,bash]
+----
+$ sudo lspci -k
+----
+
+New hardware drivers are updated continuously. If you see a device listed as unknown, query your PCI device ID database.
+
+[source,bash]
+----
+$ sudo lspci -Q
+----
+
+And update your local PCI ID database by running the command update-pciids.
+
+[source,bash]
+----
+$ sudo update-pciids
+----
+
+== ALSA Firmware
+
+The ALSA Firmware package contains firmware for various third-party sound cards.
+
+See which firmware is in use by running the following command.
+
+[source,bash]
+----
+$ sudo dnf list alsa-firmware
+----
+
+The regular ALSA Firmware will appear <alsa-firmware.noarch>.
+
+If the regular firmware is not on the output, install the alsa-firmware.
+
+[source,bash]
+----
+$ sudo dnf install alsa-firmware
+----
+
+If any other firmware is installed, put them on blocklist on configuration directory for modprobe.
+
+----
+/etc/modprobe.d/*.conf
+----
+
+Add the line on configuration file.
+
+----
+blacklist <the module to blocklist>
+----
+
+The dracut tool creates an initial image used by the kernel for preloading the block device modules. The option -f overwrite existing initramfs file.
+
+[source,bash]
+----
+$ sudo dracut -f
+----
+
+Reboot your computer for the change to take effect.
+
+[source,bash]
+----
+$ sudo reboot
+----
+
+== Hardware information
+
+It is always useful to include detailed information on your sound hardware when filing a sound-related bug. To produce this information, run this command:
+
+[source,bash]
+----
+$ alsa-info.sh --no-upload
+----
+
+It will generate a file containing detailed information about your sound hardware with the name /tmp/alsa-info.txt. Attach this file to your bug report.
+
+== Is it PipeWire?
+
+PipeWire is a media sharing server, low-level multimedia framework that aims to;
+
+* improve handling of audio and video under Linux
+
+* work for all users at all levels
+
+* offer support for PulseAudio, JACK (JACK Audio Connection Kit), ALSA and GStreamer-based applications
+
+=== Visual checks on ports
+
+Qpwgraph is a graph manager dedicated to PipeWire.
+
+Visual checks on ports using Qpwgraph will help discover all the routing between applications and devices and change the routing as you need. For example, if multiple applications and devices are connected and disconnected like below,
+
+* Firefox: video conference application using WebRTC protocol
+
+* VLC: media playback
+
+* OBS Studio: live stream and recording
+
+* USB soundcards or mixers: devices
+
+it will be useful to learn how ports are connected to applications and devices graphically.
+
+Ports are directional, they can be either:
+
+* Source ports (output). Located at the right-most edge of a node, they generate an audio/video/midi stream.
+
+* Sink ports (input). Located at the left-most edge of a node, they consume an audio/video/midi stream.
+
+Ports also have different types:
+
+* Audio (default color: green)
+
+* Video (default color: blue)
+
+* PipeWire/JACK MIDI (default color: red)
+
+* ALSA MIDI (default color: purple)
+
+Ports of the same type and opposite directions can be connected.
+
+Check the upstream documentation for user guide link:https://gitlab.freedesktop.org/rncbc/qpwgraph/-/blob/main/docs/qpwgraph-user_manual.md[Qpwgraph User Guide].
+
+=== PipeWire debugging options
+
+Debugging usually starts after the bug has been identified, and works best when users are very familiar with the circumstances surrounding the bug.
+
+PipeWire has its own debugging options. Please see the upstream documentation link:https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Troubleshooting#pipewire-debugging-options[PipeWire debugging].
+

modules/ROOT/pages/installing-mysql-mariadb.adoc

@@ -51,7 +51,7 @@ via their communication channels: https://www.mysql.com/about/faq/
 sudo dnf install mysql-community-server
 ----
 
-=== Start MySQL Service and Enable at Loggin:
+=== Start MySQL Service and Enable at login:
 
 ----
 sudo systemctl start mysqld
@@ -107,41 +107,6 @@ sudo systemctl enable {mysqld|mariadb}
 sudo systemctl start  {mysqld|mariadb}
 ----
 
-=== Installing MariaDB server from the Fedora Modular repository
-
-To list the available versions (_streams_ in modularity terminology) of MariaDB:
-
-----
-dnf module list mariadb
-----
-
-To enable the version of MariaDB you want to use and make the stream RPMs available in the package set:
-
-----
-sudo dnf module enable mariadb:10.4
-----
-
-At this point you can verify that the available RPM provides the 10.4 verison of MariaDB server:
-
-----
-dnf list mariadb-server
-----
-
-To install MariaDB server:
-
-----
-sudo dnf module install mariadb/server
-----
-
-With modules, you could also install a specific profile: like client, devel or galera (the multi-master replica).
-For instance, if you don't want to install the server stuff, but only the client packages:
-
-----
-sudo dnf module install mariadb:10.4/client
-----
-
-* MariaDB default root password is empty.
-
 === Configuring SQL before the first use
 
 ----

modules/ROOT/pages/kernel-testing-patches.adoc

@@ -59,7 +59,7 @@ or you can run the following command:
 == Applying The Patch
 
 To apply the patch, take the .patch file you've been requested to apply,
-and save it in the "kerenl" directory the previous step created as:
+and save it in the "kernel" directory the previous step created as:
 
   linux-kernel-test.patch