WIP: Meta descriptions: some fixes, add descriptions for book parts

xml/MAIN.SLE-Micro.xml

@@ -36,7 +36,7 @@
   <xi:include href="common_authors.xml"/>
  <revhistory xml:id="rh-set-micro">
    <revision>
-     <date>2024-07-01</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>
@@ -66,7 +66,7 @@
    <xi:include href="common_copyright_gfdl.xml"/>
   <revhistory xml:id="rh-art-qs-micro">
    <revision>
-     <date>2024-07-01</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>

xml/MAIN.SLEDS.xml

@@ -56,7 +56,7 @@
   <xi:include href="common_authors.xml"/>
  <revhistory xml:id="rh-set-sles">
    <revision>
-     <date>2025-03-31</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>
@@ -82,7 +82,7 @@
   <xi:include href="common_authors.xml"/>
  <revhistory xml:id="rh-set-sled">
    <revision>
-     <date>2025-03-31</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>
@@ -138,7 +138,7 @@
    </dm:docmanager>
   <revhistory xml:id="rh-set-sleds">
    <revision>
-     <date>2025-03-31</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>

xml/apps_pidgin.xml

@@ -7,7 +7,7 @@
 <chapter xmlns:its="http://www.w3.org/2005/11/its" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="cha-gnome-pidgin">
  <title><productname>Pidgin</productname>: instant messaging</title>
  <info>
-    <meta name="description" its:translate="yes">Master the features of Pidgin's instant messaging interface to communicate efficiently in real time with online contacts across various networks and protocols</meta>
+    <meta name="description" its:translate="yes">Master Pidgin’s instant messaging interface to communicate efficiently in real time across multiple networks and protocols</meta>
   <abstract>
    <para>
     Learn how to use the <productname>Pidgin</productname> instant messaging
@@ -20,7 +20,7 @@
   </dm:docmanager>
  <revhistory xml:id="rh-cha-gnome-pidgin">
    <revision>
-     <date>2022-05-18</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>

xml/audit_components.xml

@@ -7,7 +7,7 @@
 <chapter xmlns:its="http://www.w3.org/2005/11/its" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="cha-audit-comp">
  <title>Understanding Linux audit</title>
  <info>
-    <meta name="description" its:translate="yes">Learn how to configure and utilize the Linux audit framework for secure, real-time event collection and policy evaluation with this guide</meta>
+    <meta name="description" its:translate="yes">Learn how to configure and use the Linux audit framework for secure, real-time event collection and policy evaluation with this guide</meta>
       <abstract>
         <para>
     The Linux audit framework as shipped with this version of
@@ -52,7 +52,7 @@
       </dm:docmanager>
     <revhistory xml:id="rh-cha-audit-comp">
    <revision>
-     <date>2025-01-29</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>

xml/ay_faq.xml

@@ -9,14 +9,14 @@
  title="Profiling step"?><appendix xmlns:its="http://www.w3.org/2005/11/its" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="app-ay-faq">
  <title>&ay; FAQ&mdash;frequently asked questions</title>
  <info>
-    <meta name="description" its:translate="yes">Configure and manage profiles for automatic installation using SUSE's YaST tools with step-by-step documentation</meta>
+    <meta name="description" its:translate="yes">Explore common questions and their answers on mass deployment with &ay;</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
   </dm:docmanager>
  <revhistory xml:id="rh-app-ay-faq">
    <revision>
-     <date>2023-12-22</date>
+     <date>2026-04-14</date>
      <revdescription>
        <para/>
      </revdescription>

xml/book_admin_slemicro.xml

@@ -46,7 +46,8 @@
  <part xml:id="part-common">
   <title>Common tasks</title>
   <info>
-   <revhistory xml:id="rh-micro-admin-part-common">
+  <meta name="description" its:translate="yes">How to execute common tasks on SLE Micro such as working with snapshots, using transactional updates and user space live patching</meta>
+  <revhistory xml:id="rh-micro-admin-part-common">
     <revision>
      <date>2024-06-07</date>
      <revdescription>
@@ -64,6 +65,7 @@
  <part xml:id="part-networking-slemicro">
   <title>Networking</title>
   <info>
+   <meta name="description" its:translate="yes">Learn about basic networking and how to set up networks on SLE Micro using &nm;</meta>  
    <revhistory xml:id="rh-micro-admin-part-network">
     <revision>
      <date>2024-06-07</date>
@@ -80,6 +82,7 @@
  <part xml:id="part-slemicro-monitoring">
   <title>Monitoring and debugging</title>
   <info>
+  <meta name="description" its:translate="yes">How to monitor SLE Micro using the health checker, the toolbox container and Performance Co-Pilot</meta>
    <revhistory xml:id="rh-micro-admin-part-monitoring">
     <revision>
      <date>2024-06-07</date>
@@ -96,6 +99,7 @@
  <part xml:id="part-slemicro-troubleshooting">
   <title>Troubleshooting</title>
   <info>
+   <meta name="description" its:translate="yes">Learn how to gather system information for support and how to troubleshoot your SLE Micro system</meta>
    <revhistory xml:id="rh-micro-admin-part-troubleshooting">
     <revision>
      <date>2024-06-07</date>

xml/book_administration.xml

@@ -54,6 +54,7 @@
  <part xml:id="part-administration">
   <title>Common tasks</title>
   <info>
+   <meta name="description" its:translate="yes">How to execute common administration tasks such as using <command>sudo</command>, YaST, or installing and removing software</meta>
    <revhistory xml:id="rh-sle-admin-part-common">
     <revision>
      <date>2025-06-17</date>
@@ -85,6 +86,7 @@
  <part xml:id="part-boot">
   <title>Booting a Linux system</title>
   <info>
+   <meta name="description" its:translate="yes">How to boot a Linux system, using UEFI, GRUB 2 and the systemd daemon</meta>
    <revhistory xml:id="rh-sle-admin-part-boot">
     <revision>
      <date>2025-06-17</date>
@@ -105,6 +107,7 @@
  <part xml:id="part-system">
   <title>System</title>
   <info>
+   <meta name="description" its:translate="yes">How to query the systemd journal, manage networks, and manage kernels versions, modules and devices</meta>  
    <revhistory xml:id="rh-sle-admin-part-system">
     <revision>
      <date>2025-06-17</date>
@@ -133,6 +136,7 @@
  <part xml:id="part-hardware">
   <title>Hardware configuration</title>
   <info>
+   <meta name="description" its:translate="yes">How to configure hardware components such as keyboard, printer, power management, or persistent memory</meta>  
    <revhistory xml:id="rh-sle-admin-part-hardware">
     <revision>
      <date>2025-06-17</date>
@@ -155,6 +159,7 @@
  <part xml:id="part-services">
   <title>Services</title>
   <info>
+   <meta name="description" its:translate="yes">How to set up services such as NTP, DHCP, SLP, FTP or an Apache HTTP server</meta>
    <revhistory xml:id="rh-sle-admin-part-services">
     <revision>
      <date>2025-06-17</date>
@@ -180,6 +185,7 @@
  <part xml:id="part-trouble">
   <title>Troubleshooting</title>
   <info>
+   <meta name="description" its:translate="yes">Learn how to access help, gather system information for support and how to troubleshoot your system</meta>
    <revhistory xml:id="rh-sle-admin-part-trouble">
     <revision>
      <date>2025-06-17</date>

xml/book_autoyast.xml

@@ -53,6 +53,7 @@
  <part xml:id="part-control">
    <title>Understanding and creating the &ay; control file</title>
    <info>
+    <meta name="description" its:translate="yes">Learn how to create and edit XML control files that define system configuration with resources, properties and nested structures</meta>
     <revhistory xml:id="rh-autoyast-control">
      <revision>
       <date>2025-06-17</date>
@@ -71,6 +72,7 @@
  <part xml:id="part-configuration">
   <title>&ay; configuration examples</title>
    <info>
+    <meta name="description" its:translate="yes">Discover configuration details for services, user and group management, partitions, firewalls, and other key system components through practical examples</meta> 
     <revhistory xml:id="rh-autoyast-configuration">
      <revision>
       <date>2025-06-17</date>
@@ -88,6 +90,7 @@
  <part xml:id="part-dynamic-profiles">
   <title>Managing mass installations with dynamic profiles</title>
    <info>
+    <meta name="description" its:translate="yes">Learn to configure automated installations by using rules and classes, ERB templates and a combination of templates and scripts</meta> 
     <revhistory xml:id="rh-autoyast-profiles">
      <revision>
       <date>2025-06-17</date>
@@ -108,6 +111,7 @@
  <part>
   <title>Understanding the auto-installation process</title>
    <info>
+    <meta name="description" its:translate="yes">Learn how to configure and start automated installations using network boot, flash disks or kernel command-line options</meta> 
     <revhistory xml:id="rh-autoyast-auto">
      <revision>
       <date>2025-06-17</date>
@@ -125,6 +129,7 @@
  <part os="sles;sled;osuse">
   <title>Use cases for &ay; on installed systems</title>
    <info>
+    <meta name="description" its:translate="yes">Configure a YaST profile to manage both software and user accounts within an installed system, then review its settings for updates</meta>
     <revhistory xml:id="rh-autoyast-usecase">
      <revision>
       <date>2025-06-17</date>
@@ -142,6 +147,7 @@
  <part>
   <title>Appendixes</title>
    <info>
+    <meta name="description" its:translate="yes">Learn how &ay; handles rules, to configure and manage Linuxrc settings, how profiles differ in SLE 15 and 12 and explore the FAQs</meta>
     <revhistory xml:id="rh-autoyast-appendix">
      <revision>
       <date>2025-06-17</date>

xml/book_deployment.xml

@@ -50,6 +50,7 @@
  <part xml:id="part-prep">
   <title>Installation preparation</title>
    <info>
+    <meta name="description" its:translate="yes">What to consider before deployment and how to install SUSE Linux Enterprise on all supported architectures and virtualization hosts</meta> 
     <revhistory xml:id="rh-deployment-part-prep">
      <revision>
       <date>2025-06-17</date>
@@ -72,6 +73,7 @@
  <part xml:id="part-deployment">
   <title>Installation procedure</title>
   <info>
+   <meta name="description" its:translate="yes">Learn how to use boot parameters and get to know all installation steps in detail, including partitioning, installing via network and troubleshooting</meta>
    <revhistory xml:id="rh-deployment-part-installation">
     <revision>
      <date>2026-02-11</date>
@@ -91,6 +93,7 @@
  <part xml:id="part-customize-media">
   <title>Customizing installation images</title>
    <info>
+    <meta name="description" its:translate="yes">How to customize installation images manually or using tools like mksusecd or clone-master-clean-up </meta>
     <revhistory xml:id="rh-deployment-part-customize-media">
      <revision>
       <date>2025-06-17</date>
@@ -107,6 +110,7 @@
  <part xml:id="part-installserver">
   <title>Setting up an installation server</title>
    <info>
+    <meta name="description" its:translate="yes">Set up a network installation source, prepare for booting with PXE, learn how to set up an UEFI HTTP boot server or use YaST firstboot</meta> 
     <revhistory xml:id="rh-deployment-part-installserver">
      <revision>
       <date>2026-02-27</date>

xml/book_deployment_slemicro.xml

@@ -47,6 +47,7 @@
  <part xml:id="part-prep">
   <title>Installation preparation</title>
    <info>
+    <meta name="description" its:translate="yes">What to consider before deployment and how to install SUSE Linux Micro on all supported architectures</meta>
     <revhistory xml:id="rh-micro-deployment-part-prep">
      <revision>
       <date>2024-06-07</date>
@@ -64,6 +65,7 @@
  <part xml:id="part-raw-image">
   <title>Pre-built image deployment</title>
    <info>
+    <meta name="description" its:translate="yes">How to deploy pre-built images for SLE Micro, including raw images, selfinstall images and how to proceed post-deployment</meta> 
     <revhistory xml:id="rh-micro-deployment-part-image">
      <revision>
       <date>2024-06-07</date>
@@ -83,6 +85,7 @@
  <part xml:id="part-manual-installation">
   <title>Manual installation</title>
    <info>
+    <meta name="description" its:translate="yes">Learn how to use boot parameters and get to know the installation steps for SLE Micro in detail, including installation via network and troubleshooting</meta> 
     <revhistory xml:id="rh-micro-deployment-part-maninstall">
      <revision>
       <date>2024-06-07</date>

xml/deployment_prep_x86_nsysreqs.xml

@@ -12,7 +12,9 @@
  <title>Hardware requirements</title>
 
  <info>
-    <meta name="description" its:translate="yes">Learn about the minimum hardware requirements for deploying the operating system on different hardware configurations, as well as accessing certified platforms</meta>
+    <meta name="description" its:translate="yes">Learn about minimum 
+      hardware requirements for deploying the operating system 
+      on various configurations and accessing certified platforms</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker></dm:bugtracker>
    <dm:translation>yes</dm:translation>

xml/deployment_prep_zseries.xml

@@ -17,7 +17,7 @@ packagenames etc.)in all zSeries documents, because they are trademarks:
  <title>Installation on &zseries; and LinuxONE</title>
  <info>
     <meta name="description" its:translate="yes">Learn how to prepare and configure 
-    a successful installation of SUSE products on IBM Z and LinuxOne</meta>
+    a successful installation of SUSE products on IBM Z and LinuxONE</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>

xml/net_sdn.xml

@@ -12,7 +12,9 @@
  <title>Software-defined networking with &ovs;</title>
 
  <info>
-    <meta name="description" its:translate="yes">Learn about implementing software-defined networking with OVS, a distributed virtual multilayer switch that offers programmable and flexible network control</meta>
+    <meta name="description" its:translate="yes">Learn how to implement software-defined 
+            networking with OVS, a distributed virtual multilayer switch for flexible, 
+            programmable network control</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker></dm:bugtracker>
    <dm:translation>yes</dm:translation>

xml/newbie_bash.xml

@@ -7,7 +7,8 @@
 <chapter xmlns:its="http://www.w3.org/2005/11/its" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en" xml:id="cha-new-bash">
  <title>Shell basics</title>
  <info>
-     <meta name="description" its:translate="yes">Learn how to start a shell, navigate its interface, and execute basic tasks with various methods in this central resource for accessing essential Linux commands</meta></info>
+     <meta name="description" its:translate="yes">Master the basics of Linux: 
+               This section covers starting a shell, basic navigation, and executing core tasks with ease</meta></info>
  <para>
   When working with Linux, you can communicate with the system
   almost without ever requiring a command line interpreter (the shell).

xml/newbie_bash_commands_i.xml

@@ -10,7 +10,9 @@
   xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Important Linux commands</title>
  <info>
-  <meta name="description" its:translate="yes">Learn effective Linux file management skills by accessing a comprehensive list of important commands and their usage, covering file administration, copying</meta></info>
+  <meta name="description" its:translate="yes">Learn effective Linux file management by 
+      accessing a list of important commands and usage tips, covering file administration, 
+      copying, and more</meta></info>
  <para>
   This section provides an overview of the most important Linux commands. There are
   many more commands than listed in this chapter. Along with the individual