First batch of suggestions from code review

taroth21 · dariavladykina · web-flow · commit 98a6f6db75ec · 2026-04-14T10:43:59.000+02:00
Co-authored-by: Daria Vladykina &lt;daria.vladykina@suse.com&gt;
diff --git a/xml/advanced_disksetup.xml b/xml/advanced_disksetup.xml
@@ -4,13 +4,14 @@
   %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-advdisk">
+<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-advdisk">
 <!-- bg: remaining content of this should go to planning
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="inst_partition.xml"/>
  -->
  <title>Advanced Disk Setup</title>
  <info>
-  <meta name="description">Understand advanced storage configurations on SUSE Linux Enterprise Server including LVM, RAID, and multipath setups for optimized disk management and data</meta>
+  <meta name="description" its:translate="yes">Understand advanced storage configurations on SUSE Linux Enterprise Server, including LVM, RAID, and multipath setups for optimized disk management and data</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker>
 <!--          <dm:assignee></dm:assignee>-->
diff --git a/xml/apps_brasero.xml b/xml/apps_brasero.xml
@@ -10,10 +10,10 @@
  2.Advanced image building through Brasero
  See FATE #305163
 -->
-<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-gnome-burn">
+<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-gnome-burn">
  <title>Brasero: Burning CDs and DVDs</title>
  <info>
-  <meta name="description">Create and burn data or audio CDs and DVDs on SUSE Linux Enterprise using the Brasero application to manage your optical media projects with ease</meta>
+  <meta name="description" its:translate="yes">Create and burn data or audio CDs and DVDs on SUSE Linux Enterprise using the Brasero application to manage your optical media projects with ease</meta>
   <abstract>
    <para>
     Brasero is a &gnome; program for writing data and audio CDs and DVDs. Start
diff --git a/xml/apps_empathy.xml b/xml/apps_empathy.xml
@@ -8,10 +8,10 @@
 <!-- SLE 12 ships with Empathy, Pidgin needs to be installed later ... We should
 probably replace the Pidgin & Ekiga chapters with an Empathy chapter at some point.
 - sknorr, 2015-09-22 -->
-<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-gnome-empathy">
+<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-gnome-empathy">
  <title>Empathy: Instant Messaging</title>
  <info>
-  <meta name="description">Set up and use the Empathy instant messaging client on SUSE Linux Enterprise to communicate across multiple accounts and protocols simultaneously</meta>
+  <meta name="description" its:translate="yes">Set up and use the Empathy instant messaging client on SUSE Linux Enterprise to communicate across multiple accounts and protocols simultaneously</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
diff --git a/xml/apps_gftp.xml b/xml/apps_gftp.xml
@@ -7,10 +7,10 @@
 <!--
   openSUSE 11.2 M5 2.0.19
 -->
-<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-gnome-gftp">
+<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-gnome-gftp">
  <title>gFTP: Transferring Data from the Internet</title>
  <info>
-  <meta name="description">Use gFTP on SUSE Linux Enterprise to transfer data via FTP, HTTP, and SSH while managing bookmarks and configuring proxy settings for secure access</meta>
+  <meta name="description" its:translate="yes">Use gFTP on SUSE Linux Enterprise to transfer data via FTP, HTTP, and SSH while managing bookmarks and configuring proxy settings for secure access</meta>
   <abstract>
    <para>
     gFTP is a multithreaded file transfer client. It supports the FTP, FTPS
diff --git a/xml/ay_bigfile.xml b/xml/ay_bigfile.xml
@@ -16991,7 +16991,7 @@ autoyast: file:///info
  <appendix xml:id="app-ay-faq">
   <title>&ay; FAQ - Frequently Asked Questions</title>
   <info>
-    <meta name="description" its:translate="yes">Explore common questions and their answers on mass deployement with &ay;</meta>
+    <meta name="description" its:translate="yes">Explore common questions and their answers on mass deployment with &ay;</meta>
     <revhistory xml:id="rh-ay-faq">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/book_quickstarts.xml b/xml/book_quickstarts.xml
@@ -22,7 +22,7 @@
       </dm:docmanager>
     <revhistory xml:id="rh-book-quickstarts">
    <revision>
-     <date></date>
+     <date>2026-04-09</date>
      <revdescription>
        <para/>
      </revdescription>
diff --git a/xml/containers_basics.xml b/xml/containers_basics.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-containers-intro">
+<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-containers-intro">
  <title>Introduction to Linux Containers</title>
  <info>
-  <meta name="description">Manage Docker containers on SUSE Linux Enterprise by learning how to create, start, stop, and remove them using the command line interface</meta>
+  <meta name="description" its:translate="yes">Manage Docker containers on SUSE Linux Enterprise by learning how to create, start, stop and remove them using the command-line interface</meta>
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:bugtracker>
         </dm:bugtracker>
diff --git a/xml/deployment_prep_boot.xml b/xml/deployment_prep_boot.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" role="General" xml:id="cha-deployment-prep-boot">
+<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" role="General" xml:id="cha-deployment-prep-boot">
  <title>Preparing the Boot of the Target System</title>
  <info>
-  <meta name="description">Prepare for SUSE Linux Enterprise Server installation by configuring boot parameters and selecting the appropriate boot medium for your hardware environment</meta>
+  <meta name="description" its:translate="yes">Prepare for SUSE Linux Enterprise Server installation by configuring boot parameters and selecting the boot medium for your hardware environment</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
diff --git a/xml/deployment_prep_zseries_info_i.xml b/xml/deployment_prep_zseries_info_i.xml
@@ -292,7 +292,7 @@
    <title>MicroCode Level, APARs, and Fixes</title>
    <para>
     Documentation about restrictions and requirements for this release of &sls;
-    be found on IBM developerWorks at <link xlink:href="http://www.ibm.com/developerworks/linux/linux390/documentation_suse.html"/>.
+    can be found on IBM developerWorks at <link xlink:href="http://www.ibm.com/developerworks/linux/linux390/documentation_suse.html"/>.
     It is recommended always to use the highest service level available.
     Contact your IBM support for minimum requirements.
    </para>
diff --git a/xml/docker_building_images.xml b/xml/docker_building_images.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="docker-building-images" 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="docker-building-images" xml:lang="en">
  <title>Creating Custom Images</title>
  <info>
-  <meta name="description">Learn how to build custom Docker images on SUSE Linux Enterprise using Dockerfiles to automate the creation of consistent container environments</meta>
+  <meta name="description" its:translate="yes">Learn how to build custom Docker images on SUSE Linux Enterprise using Dockerfiles to automate the creation of consistent container environments</meta>
  
  <revhistory xml:id="rh-cha-docker-building-images">
   <revision>
diff --git a/xml/docker_containers.xml b/xml/docker_containers.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-working-with-containers" 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-working-with-containers" xml:lang="en">
         <title>Working with Containers</title>
         <info>
-                <meta name="description">Learn how to build custom Docker images on SUSE Linux Enterprise using Dockerfiles to automate the creation of consistent container environments</meta>
+                <meta name="description" its:translate="yes">Learn how to build custom Docker images on SUSE Linux Enterprise using Dockerfiles to automate the creation of consistent container environments</meta>
                
                <revhistory xml:id="rh-cha-working-with-containers">
                 <revision>
diff --git a/xml/docker_dockerizing_application.xml b/xml/docker_dockerizing_application.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="docker-dockerizing-application" 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="docker-dockerizing-application" xml:lang="en">
         <title>Creating &docker; Images of Applications</title>
         <info>
-                <meta name="description">Explore the process of dockerizing applications on SUSE Linux Enterprise to create portable, self-contained units for efficient software deployment</meta>
+                <meta name="description" its:translate="yes">Explore the process of dockerizing applications on SUSE Linux Enterprise to create portable, self-contained units for efficient software deployment</meta>
                
                <revhistory xml:id="rh-cha-docker-dockerizing-application">
                 <revision>
diff --git a/xml/docker_installation.xml b/xml/docker_installation.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-docker-installation" 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-docker-installation" xml:lang="en">
         <title>&deng; Installation</title>
         <info>
-          <meta name="description">Install and configure the Docker Open Source Engine on SUSE Linux Enterprise to begin deploying and managing containerized applications effectively</meta>
+          <meta name="description" its:translate="yes">Install and configure the Docker Open Source Engine on SUSE Linux Enterprise to deploy and manage containerized applications effectively</meta>
          
          <revhistory xml:id="rh-cha-docker-installation">
           <revision>
diff --git a/xml/docker_overview.xml b/xml/docker_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="cha-docker-overview" 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-docker-overview" xml:lang="en">
  <title>&deng; Overview</title>
  <info>
-  <meta name="description">Discover how the Docker Open Source Engine enables lightweight virtualization on SUSE Linux Enterprise through efficient container isolation techniques</meta>
+  <meta name="description" its:translate="yes>Discover how the Docker Open Source Engine enables lightweight virtualization on SUSE Linux Enterprise through efficient container isolation techniques</meta>
  
  <revhistory xml:id="rh-cha-docker-overview">
   <revision>
diff --git a/xml/docker_registry.xml b/xml/docker_registry.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-registry-installation" 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-registry-installation" xml:lang="en">
 <title>Storing Images</title>
 <info>
-  <meta name="description">Deploy and manage a private Docker registry on SUSE Linux Enterprise to securely store, share, and distribute custom container images internally</meta>
+  <meta name="description" its:translate="yes>Deploy and manage a private Docker registry on SUSE Linux Enterprise to securely store, share and distribute custom container images internally</meta>
  
  <revhistory xml:id="rh-cha-registry-installation">
   <revision>
diff --git a/xml/docker_sle2docker.xml b/xml/docker_sle2docker.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-sle2docker-installation" 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-sle2docker-installation" xml:lang="en">
 <title>Installing <literal>sle2docker</literal></title>
 <info>
-	<meta name="description">Convert SUSE Linux Enterprise images into Docker base images using the sle2docker tool to streamline application containerization on enterprise systems</meta>
+	<meta name="description" its:translate="yes">Convert SUSE Linux Enterprise images into Docker base images using the sle2docker tool to streamline application containerization on enterprise systems</meta>
    
    <revhistory xml:id="rh-cha-sle2docker-installation">
 	<revision>
diff --git a/xml/docker_troubleshoot.xml b/xml/docker_troubleshoot.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-containers-troubleshoot">
+<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-containers-troubleshoot">
  <info>
   <title>Troubleshooting</title>
-  <meta name="description">Resolve common Docker issues on SUSE Linux Enterprise by applying troubleshooting techniques for containers, networking, and storage systems</meta>
+  <meta name="description" its:translate="yes">Resolve common Docker issues on SUSE Linux Enterprise by applying troubleshooting techniques for containers, networking, and storage systems</meta>
  <revhistory xml:id="rh-cha-containers-troubleshoot">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/gnome_admin.xml b/xml/gnome_admin.xml
@@ -29,10 +29,10 @@
 <!--taroth 081017: regarding firefox bridge and lockdown, also check out
  the following fate entries: #301534, 302023, 302024, 302911-->
 <!--ke 20090213: firefox lock down mentioned -->
-<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-gnome-gconf">
+<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-gnome-gconf">
  <title>&gnome; Configuration for Administrators</title>
  <info>
-  <meta name="description">Explore essential administrative tasks and configuration options for managing the GNOME desktop environment on SUSE Linux Enterprise</meta>
+  <meta name="description" its:translate="yes">Explore essential administrative tasks and configuration options for managing the GNOME desktop environment on SUSE Linux Enterprise</meta>
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:bugtracker>
         </dm:bugtracker>
diff --git a/xml/image_kiwi.xml b/xml/image_kiwi.xml
@@ -4,7 +4,7 @@
   %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-kiwi">
+<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-kiwi">
 <!-- More ore less in the abstract -->
 <!--<sect1 id="sec-kiwi-about">
     <title>What is &kiwi;?</title>
@@ -84,7 +84,7 @@
         <dm:bugtracker>
           </dm:bugtracker>
       </dm:docmanager>
-      <meta name="description">Learn how to configure the KIWI boot loader to correctly locate and boot system images from various storage devices on SUSE Linux Enterprise systems</meta>
+      <meta name="description" its:translate="yes">Learn how to configure the KIWI boot loader to correctly locate and boot system images from various storage devices on SUSE Linux Enterprise systems</meta>
     <revhistory xml:id="rh-cha-kiwi">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/image_kiwi_pointer.xml b/xml/image_kiwi_pointer.xml
@@ -8,7 +8,7 @@
   * This file is referenced by book_sle_deployment. Delete if no longer needed.
   * If we keep it, make sure link to cha.imgcreator is still correct.
 -->
-<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-kiwi-pointer">
+<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-kiwi-pointer">
  <title>Creating Images with &kiwi;</title>
  <info>
       <abstract>
@@ -28,7 +28,7 @@
       <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
         <dm:translation>yes</dm:translation>
       </dm:docmanager>
-      <meta name="description">Learn how to configure the KIWI boot loader to correctly locate and boot system images from various storage devices on SUSE Linux Enterprise systems</meta>
+      <meta name="description" its:translate="yes">Learn how to configure the KIWI boot loader to correctly locate and boot system images from various storage devices on SUSE Linux Enterprise systems</meta>
     <revhistory xml:id="rh-cha-kiwi-pointer">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/inst_yast2.xml b/xml/inst_yast2.xml
@@ -4,7 +4,7 @@
   %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-inst">
+<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-inst">
  <title>Installation with &yast;</title>
  <info>
   <abstract>
@@ -38,7 +38,7 @@
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>
   </dm:docmanager>
-  <meta name="description">Learn how to use the YaST2 installation tool on SUSE Linux to perform automated or manual system deployments and hardware configurations</meta>
+  <meta name="description" its:translate="yes">Learn how to use the YaST2 installation tool on SUSE Linux to perform automated or manual system deployments and hardware configurations</meta>
  <revhistory xml:id="rh-cha-inst">
    <revision>
      <date>2026-04-09</date>
diff --git a/xml/kgraft.xml b/xml/kgraft.xml
diff --git a/xml/kvm_appendix.xml b/xml/kvm_appendix.xml
diff --git a/xml/kvm_limitations.xml b/xml/kvm_limitations.xml
diff --git a/xml/kvm_support_status.xml b/xml/kvm_support_status.xml
diff --git a/xml/libvirt_configuration.xml b/xml/libvirt_configuration.xml
diff --git a/xml/libvirt_networking.xml b/xml/libvirt_networking.xml
