From 9826ecf4eb9caca7d042b96b657dedc4d8af471c Mon Sep 17 00:00:00 2001
From: Yuri Chornoivan <yurchor@ukr.net>
Date: Mon, 8 May 2023 17:18:16 +0300
Subject: Update docs from Calenco

---
 docs/docs/stable/installer/en/installer.xml   |  4 +-
 docs/docs/stable/installer/en/soundConfig.xml | 53 +++++++--------------------
 2 files changed, 16 insertions(+), 41 deletions(-)

diff --git a/docs/docs/stable/installer/en/installer.xml b/docs/docs/stable/installer/en/installer.xml
index 3fa0bf2f..e1846eda 100644
--- a/docs/docs/stable/installer/en/installer.xml
+++ b/docs/docs/stable/installer/en/installer.xml
@@ -100,7 +100,7 @@
 
       <mediaobject>
         <imageobject>
-          <imagedata align="center" fileref="dx-welcome.png"/>
+          <imagedata align="center" fileref="../dx-welcome.png"/>
         </imageobject>
       </mediaobject>
 
@@ -148,7 +148,7 @@
 
       <mediaobject>
         <imageobject>
-          <imagedata align="center" fileref="dx-welcome2.png"/>
+          <imagedata align="center" fileref="../dx-welcome2.png"/>
         </imageobject>
       </mediaobject>
 
diff --git a/docs/docs/stable/installer/en/soundConfig.xml b/docs/docs/stable/installer/en/soundConfig.xml
index ad271af5..f761d4c4 100644
--- a/docs/docs/stable/installer/en/soundConfig.xml
+++ b/docs/docs/stable/installer/en/soundConfig.xml
@@ -1,52 +1,27 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<section version="5.0" xml:id="soundConfig"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:ns5="http://www.w3.org/1998/Math/MathML"
-         xmlns:ns4="http://www.w3.org/2000/svg"
-         xmlns:ns3="http://www.w3.org/1999/xhtml"
-         xmlns:ns2="http://www.w3.org/1999/xlink"
-         xmlns:ns="http://docbook.org/ns/docbook">
+<?xml version='1.0' encoding='UTF-8'?><section xmlns="http://docbook.org/ns/docbook" xmlns:ns="http://docbook.org/ns/docbook" xmlns:ns2="http://www.w3.org/1999/xlink" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:ns4="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1998/Math/MathML" xml:id="soundConfig" version="5.0">
   <info>
     <title xml:id="soundConfig-ti1">Sound Configuration</title>
   </info>
-
   <!-- Lebarhon 20170209 updated SC-->
-
-  <!--2018/02/13 apb: Text and typography.-->
-
-  <!--2018/02/17 apb: Centre-align PNG-->
-
   <mediaobject>
     <imageobject>
-      <imagedata align="center" fileref="dx2-soundConfig.png" format="PNG"
-                 revision="1" xml:id="soundConfig-im1"/>
+      <imagedata format="PNG" fileref="dx2-soundConfig.png" xml:id="soundConfig-im1" revision="1"/>
     </imageobject>
   </mediaobject>
-
-  <para>This screen shows the details of the sound card driver chosen for you
-  by the installer, and this driver should work without problems.</para>
-
-  <para>However, if you encounter any issues post-install, then run
-  <command>draksound</command> or start this tool via <menuchoice>
-      <guimenu>Mageia Control Center</guimenu>
-
-      <guimenuitem>Hardware</guimenuitem>
-
-      <guimenuitem>Sound Configuration</guimenuitem>
-    </menuchoice>. Then, in the <literal>draksound</literal> or
-  <emphasis>Sound Configuration</emphasis> screen, click on
-  <emphasis>Troubleshooting</emphasis> to find useful advice about how to
-  solve the problem.</para>
-
+  <para>In this screen the name of the driver that the installer chose for
+  your sound card is given, which will be the default driver if one
+  exists.</para>
+  <para>The default driver should work without problems. However, if after
+  install you do encounter problems, then run <command>draksound</command> or
+  start this tool via MCC (Mageia Control Center), by choosing the
+  <guilabel>Hardware</guilabel> tab and clicking on <guilabel>Sound
+  Configuration</guilabel> at the top right of the screen.</para>
+  <para>With this tool, you can choose which backend will become the sound server, so manage the sound. You have the choice between pulseaudio and pipewire. For the second, you can choose a session manager <literal>Wireplumber</literal> or <literal>Pipewire Media Session</literal>. After applying the new configuration, the needed packages will be installed and services configured.</para>
   <section xml:id="soundConfig-Advanced">
     <info>
       <title xml:id="soundConfig-Advanced-ti1">Advanced</title>
     </info>
-
-    <para>If there is no actual default driver for your sound card, there may
-    be other possible alternative drivers available to choose from. If this is
-    the case, but you think the installer has not made the most appropriate
-    choice, you can click on <emphasis>Advanced</emphasis> to manually specify
-    a driver.</para>
+    <para>Clicking <emphasis role="bold"><guibutton>Advanced</guibutton></emphasis> in this screen, you will have the choice to reset the sound mixer configuration to default values.</para>
+    <para/>
   </section>
-</section>
+</section>
\ No newline at end of file
-- 
cgit v1.2.1