Added Meta Descriptions (#1878)

* autogenerated meta descriptions for XML files
* corrected ~50% of descriptions manually
* fixed validation issues (<info/> not allowed everywhere)
* removed report about autogenerated descriptions from file system
   (still available in the PR as attachment)

---------

Co-authored-by: Daria Vladykina <daria.vladykina@suse.com>
Co-authored-by: Tanja Roth <taroth@suse.com>

Author: 3 people

xml/64bit_issues.xml

@@ -4,10 +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="cha-64bit">
+<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-64bit">
  <title>32-bit and 64-bit applications in a 64-bit system environment</title>
 
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Configure your 64-bit environment to run existing 32-bit applications without requiring additional ports</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>

xml/MAIN.SLE-Micro.xml

@@ -10,7 +10,9 @@
 <?dbhtml filename="index.html"?>
 
  <title>&productname; Documentation</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Learn how to configure, deploy and manage SUSE Linux Micro
+    with comprehensive documentation for administrators and edge developers</meta>
   <productname>&productname;</productname>
   <productname role="abbrev">&productnameshort;</productname>
   <productnumber>&productnumber;</productnumber>

xml/MAIN.SLEDS.xml

@@ -31,7 +31,8 @@
 <!-- Quick Starts                                                          -->
 <!--                                                                       -->
  <title>&productname; Documentation</title>
- <info xmlns:d="http://docbook.org/ns/docbook" os="sles">
+ <info os="sles">
+    <meta name="description" its:translate="yes">Learn to configure, deploy and manage SUSE Linux Enterprise Desktop with comprehensive guides for secure, cost-effective enterprise use</meta>
   <productname>&productname;</productname>
   <productname role="abbrev">&productnameshort;</productname>
   <productnumber>&productnumber;</productnumber>

xml/MAIN.opensuse.xml

@@ -6,10 +6,12 @@
 
 <?xml-stylesheet href="urn:x-suse:xslt:profiling:docbook50-profile.xsl"
                  type="text/xml"
-                 title="Profiling step"?><set xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.2" xml:lang="en" xml:id="set-opensuse">
+                 title="Profiling step"?><set 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.2" xml:lang="en" xml:id="set-opensuse">
 <?dbhtml filename="index.html"?>
 <title>&productname; Documentation</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Learn how to configure, deploy and manage 
+    openSUSE with comprehensive documentation for system administrators and desktop users</meta>
   <productname>&productname;</productname>
   <productname role="abbrev">&productnameshort;</productname>
   <productnumber>&productnumber;</productnumber>

xml/aarch64_inst_problem.xml

@@ -5,10 +5,11 @@
   <!ENTITY % entities SYSTEM "generic-entities.ent">
     %entities;
 ]>
-<sect1 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="sec-bootproblem-aarch64">
+<sect1 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="sec-bootproblem-aarch64">
  <title>Dealing with boot and installation problems</title>
 
  <info>
+    <meta name="description" its:translate="yes">Configure your system to log system messages at boot time and troubleshoot boot and installation issues</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker></dm:bugtracker>
    <dm:translation>yes</dm:translation>

xml/adm_shell.xml

@@ -4,10 +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="cha-adm-shell">
+<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-adm-shell">
 <!-- Better Title? -->
  <title>Bash and Bash scripts</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Manage tasks and automate processes with the Bash shell using its powerful commands and features, then apply your newfound skills in practice</meta>
   <abstract>
    <para>
     Today, many people use computers with a graphical user interface (GUI)

xml/adm_sudo.xml

@@ -4,9 +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-adm-sudo">
+<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-adm-sudo">
   <title>&sudo; basics</title>
-  <info xmlns:d="http://docbook.org/ns/docbook">
+  <info>
+    <meta name="description" its:translate="yes">Configure sudo settings to manage user permissions and secure access to elevated commands in your Linux system</meta>
     <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
       <dm:bugtracker/>
       <dm:translation>yes</dm:translation>

xml/adm_support.xml

@@ -4,10 +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="cha-adm-support">
+<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-adm-support">
 
  <title>Gathering system information for support</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Learn about accessing detailed system information, creating problem reports, and analyzing SupportConfig output with SUSE tools</meta>
   <abstract>
    <para>
     For a quick overview of all relevant system information of a machine,

xml/adm_wbem.xml

@@ -4,9 +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-wbem">
+<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-wbem">
  <title>Web Based Enterprise Management using SFCB</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Learn about implementing enterprise management solutions using open standards-based tools from the DMTF</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>

xml/administration_intro.xml

@@ -4,9 +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="preface-administration-slemicro">
+<preface 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="preface-administration-slemicro">
  <title>Preface</title>
- <info xmlns:d="http://docbook.org/ns/docbook">
+ <info>
+    <meta name="description" its:translate="yes">Access documentation, browse or download formats online, search the SUSE Knowledgebase for known solutions, and report any issues you encounter</meta>
   <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
    <dm:bugtracker/>
    <dm:translation>yes</dm:translation>