2nd batch of suggestions from code review

taroth21 · dariavladykina · web-flow · commit e2057eb96b4f · 2026-04-14T11:04:22.000+02:00
Co-authored-by: Daria Vladykina &lt;daria.vladykina@suse.com&gt;
diff --git a/xml/libvirt_networking.xml b/xml/libvirt_networking.xml
@@ -7,7 +7,7 @@
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-libvirt-networks">
  <title>Managing Networks</title>
  <info>
-  <meta name="description">Learn how to configure and manage network bridges and virtual networks using libvirt to provide connectivity for virtual machines on your host system</meta>
+  <meta name="description" its:translate="yes">Learn how to configure and manage network bridges and virtual networks using libvirt to provide connectivity for virtual machines on your host system</meta>
   <abstract>
    <para>
     This chapter describes common network configurations for a &vmhost;,
diff --git a/xml/net_nfs.xml b/xml/net_nfs.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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-nfs">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-nfs">
  <title>Sharing File Systems with NFS</title>
  <info>
-  <meta name="description">Configure and manage Network File System services to share directories across your network using the YaST configuration tool or manual editing methods</meta>
+  <meta name="description" its:translate="yes">Configure and manage Network File System services to share directories across your network using the YaST configuration tool or manual editing methods</meta>
   <abstract>
    <para>
     The <emphasis>Network File System</emphasis> (<emphasis>NFS</emphasis>)
diff --git a/xml/pcmcia_apm.xml b/xml/pcmcia_apm.xml
@@ -14,10 +14,10 @@
      I removed pm-utils references.  Maybe, we should mention the
      systemd backgorund in the future.
 -->
-<chapter 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-pmanage">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-pmanage">
  <title>Power Management</title>
  <info>
-  <meta name="description">Learn how to configure power management and PCMCIA services on your system to optimize mobile computing performance and hardware compatibility features</meta>
+  <meta name="description" its:translate="yes">Learn how to configure power management and PCMCIA services on your system to optimize mobile computing performance and hardware compatibility features</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
diff --git a/xml/security_policy_kit.xml b/xml/security_policy_kit.xml
@@ -7,7 +7,7 @@
 <!-- toms 2014-02-24: GUIs for GNOME and KDE removed as they are not
      existant anymore :-(
 -->
-<chapter 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-security-policykit">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-security-policykit">
  <title>Authorization with &pk;</title>
  <info>
       <abstract>
@@ -24,7 +24,7 @@
     the action in question.
    </para>
       </abstract>
-      <meta name="description">Explore how to manage system-wide privileges and desktop security policies using PolicyKit to control authorized actions for unprivileged processes on Linux</meta>
+      <meta name="description" its:translate="yes">Explore how to manage system-wide privileges and desktop security policies with PolicyKit to control authorized actions for unprivileged processes on Linux</meta>
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:bugtracker>
           </dm:bugtracker>
diff --git a/xml/security_yast2_ca.xml b/xml/security_yast2_ca.xml
@@ -19,7 +19,7 @@
 
  2013-02-21: No changes for SP3 according to mc
 -->
-<chapter 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-security-yast-ca">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-security-yast-ca">
  <title>Managing X.509 Certification</title>
  <info>
       <abstract>
@@ -41,7 +41,7 @@
     &yast; to create and administer certificates of this type.
    </para>
       </abstract>
-      <meta name="description">Use the YaST CA management module to create and manage your own public key infrastructure by generating root and intermediate certificates for your network</meta>
+      <meta name="description" its:translate="yes">Use the YaST CA management module to create and manage your own public key infrastructure by generating root and intermediate certificates for your network</meta>
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:bugtracker>
           </dm:bugtracker>
diff --git a/xml/smt_advanced.xml b/xml/smt_advanced.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-advanced">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-advanced">
  <title>Advanced Topics</title>
  <info>
-  <meta name="description">Explore advanced configuration for the Subscription Management Tool to perform server backups and manage installations in disconnected network environments</meta>
+  <meta name="description" its:translate="yes">Explore advanced configuration for the Subscription Management Tool to perform server backups and manage installations in disconnected network environments</meta>
   <revhistory xml:id="rh-smt-advanced">
   <revision>
     <date>2026-04-09</date>
diff --git a/xml/smt_client.xml b/xml/smt_client.xml
@@ -4,11 +4,11 @@
   %entities;
 ]>
 
-<chapter 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="smt-client">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-client">
 <!-- ================================================================== -->
  <title>Configuring Clients to Use &smt;</title>
   <info>
-     <meta name="description">Configure client machines to register with a local Subscription Management Tool server and download software updates using various setup methods</meta>   
+     <meta name="description" its:translate="yes">Configure client machines to register with a local Subscription Management Tool server and download software updates using various setup methods</meta>   
   <revhistory xml:id="rh-smt-client">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_install.xml b/xml/smt_install.xml
@@ -4,11 +4,11 @@
   %entities;
 ]>
 
-<chapter 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="smt-installation">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-installation">
 <!-- ==================================================================== -->
  <title>&smt; Installation</title>
  <info>
-  <meta name="description">Install and configure the Subscription Management Tool using the YaST wizard to manage product registrations and updates for your local network clients</meta>
+  <meta name="description" its:translate="yes">Install and configure the Subscription Management Tool using the YaST wizard to manage product registrations and updates for your local network clients</meta>
   <revhistory xml:id="rh-smt-installation">
   <revision>
     <date>2026-04-09</date>
diff --git a/xml/smt_management.xml b/xml/smt_management.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-management">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-management">
  <title>Managing Repositories with &yast; &smt; Server Management</title>
  <info>
-  <meta name="description">Manage software repositories, staging environments, and client update statuses using the YaST SMT Server Management module on your network server</meta>
+  <meta name="description" its:translate="yes">Manage software repositories, staging environments, and client update statuses using the YaST SMT Server Management module on your network server</meta>
   <revhistory xml:id="rh-smt-management">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_mirroring.xml b/xml/smt_mirroring.xml
@@ -4,11 +4,11 @@
   %entities;
 ]>
 
-<chapter 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="smt-mirroring">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-mirroring">
 <!-- ==================================================================== -->
  <title>Mirroring Repositories on the &smt; Server</title>
  <info>
-  <meta name="description">Mirror installation and update repositories on the SMT server to save bandwidth and manage local software updates for your network clients</meta>
+  <meta name="description" its:translate="yes">Mirror installation and update repositories on the SMT server to save bandwidth and manage local software updates for your network clients</meta>
   <revhistory xml:id="rh-smt-mirroring">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_overview.xml b/xml/smt_overview.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<preface 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="pre-smt">
+<preface xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="pre-smt">
  <title>About This Guide</title>
  <info>
-  <meta name="description">Use the Subscription Management Tool to optimize software update management and subscription entitlements for your enterprise Linux systems</meta>
+  <meta name="description" its:translate="yes">Use the Subscription Management Tool to optimize software update management and subscription entitlements for your enterprise Linux systems</meta>
   <revhistory xml:id="rh-pre-smt">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_product_overview.xml b/xml/smt_product_overview.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-overview">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-overview">
  <title>Overview</title>
  <info>
-  <meta name="description">Get a high-level overview of the Subscription Management Tool features to centrally manage software updates and entitlements for your Linux enterprise</meta>
+  <meta name="description" its:translate="yes">Get a high-level overview of the Subscription Management Tool features to centrally manage software updates and entitlements for your Linux enterprise</meta>
   <revhistory xml:id="rh-smt-overview">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_registration.xml b/xml/smt_registration.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-registration">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-registration">
  <title>Managing Client Machines with &smt;</title>
  <info>
-  <meta name="description">Manage client machine registrations and license compliance using the Subscription Management Tool to monitor product usage and update schedules</meta>
+  <meta name="description" its:translate="yes">Manage client machine registrations and license compliance using the Subscription Management Tool to monitor product usage and update schedules</meta>
   <revhistory xml:id="rh-smt-registration">
   <revision>
     <date>2026-04-09</date>
diff --git a/xml/smt_reporting.xml b/xml/smt_reporting.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-reporting">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-reporting">
  <title>&smt; Reports</title>
  <info>
-  <meta name="description">Generate and manage Subscription Management Tool reports to track registered machines and subscription entitlements in various output formats</meta>
+  <meta name="description" its:translate="yes">Generate and manage Subscription Management Tool reports to track registered machines and subscription entitlements in various output formats</meta>
   <revhistory xml:id="rh-smt-reporting">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_server.xml b/xml/smt_server.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-server">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-server">
  <title>&smt; Server Configuration</title>
  <info>
-  <meta name="description">Configure the Subscription Management Tool server by setting mirroring credentials, database passwords, and job schedules using the YaST module</meta>
+  <meta name="description" its:translate="yes">Configure the Subscription Management Tool server by setting mirroring credentials, database passwords and job schedules using the YaST module</meta>
   <revhistory xml:id="rh-smt-server">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/smt_tools.xml b/xml/smt_tools.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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="smt-tools">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="smt-tools">
  <title>&smt; Tools and Configuration Files</title>
  <info>
-  <meta name="description">Explore the essential command-line tools, configuration files, and certificates used to manage and secure your Subscription Management Tool server</meta>
+  <meta name="description" its:translate="yes">Explore the essential command-line tools, configuration files, and certificates used to manage and secure your Subscription Management Tool server</meta>
   <revhistory xml:id="rh-smt-tools">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/storage_iscsi-lio.xml b/xml/storage_iscsi-lio.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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-iscsi-lio" xml:lang="en">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-iscsi-lio" xml:lang="en">
  <title>Mass Storage over IP Networks: iSCSI LIO Target Server</title>
  <info>
-  <meta name="description">Learn how to configure and manage iSCSI target and initiator services using the LIO kernel subsystem to provide networked block storage on your system</meta>
+  <meta name="description" its:translate="yes">Learn how to configure and manage iSCSI target and initiator services using the LIO kernel subsystem to provide networked block storage on your system</meta>
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:bugtracker>
           </dm:bugtracker>
diff --git a/xml/storage_nfs-acl.xml b/xml/storage_nfs-acl.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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-nfs4-acls" xml:lang="en">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-nfs4-acls" xml:lang="en">
  <title>Managing Access Control Lists over NFSv4</title>
  <info>
-  <meta name="description">Implement Access Control Lists on NFS exports to provide fine-grained security and precise permission management for shared files and directories</meta>
+  <meta name="description" its:translate="yes">Implement Access Control Lists on NFS exports to provide fine-grained security and precise permission management for shared files and directories</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
diff --git a/xml/storage_troubleshooting.xml b/xml/storage_troubleshooting.xml
@@ -4,10 +4,10 @@
   %entities;
 ]>
 
-<chapter 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-storage-trouble" xml:lang="en">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-storage-trouble" xml:lang="en">
  <title>Troubleshooting Storage Issues</title>
  <info>
-  <meta name="description">Identify and resolve common storage issues by using diagnostic tools and troubleshooting procedures for block devices and file systems on your system</meta>
+  <meta name="description" its:translate="yes">Identify and resolve common storage issues by using diagnostic tools and troubleshooting procedures for block devices and file systems on your system</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
diff --git a/xml/tuning_perfmon.xml b/xml/tuning_perfmon.xml
@@ -18,10 +18,10 @@
  * SLE11 SP2: perf-3.0.6-2.6.91.x86_64
 
 -->
-<chapter 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-tuning-perfmon2">
+<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:its="http://www.w3.org/2005/11/its" version="5.0" xml:id="cha-tuning-perfmon2">
  <title>Perfmon2&mdash;Hardware-Based Performance Monitoring</title>
  <info>
-  <meta name="description">Monitor system performance and identify bottlenecks using various profiling tools and utilities to optimize the efficiency of your Linux environment</meta>
+  <meta name="description" its:translate="yes">Monitor system performance and identify bottlenecks using various profiling tools and utilities to optimize the efficiency of your Linux environment</meta>
       <abstract>
         <para>
     Perfmon2 is a standardized, generic interface to access the performance
diff --git a/xml/xen_guest_suse.xml b/xml/xen_guest_suse.xml
diff --git a/xml/xen_intro.xml b/xml/xen_intro.xml
diff --git a/xml/yast2_hw.xml b/xml/yast2_hw.xml
diff --git a/xml/yast2_sw_addon.xml b/xml/yast2_sw_addon.xml
