Skip to content

Backport Meta Descriptions to SLE 12 SP5#1914

Open
taroth21 wants to merge 8 commits intomaintenance/SLE12SP5from
taroth/metadescr_backport_12sp5
Open

Backport Meta Descriptions to SLE 12 SP5#1914
taroth21 wants to merge 8 commits intomaintenance/SLE12SP5from
taroth/metadescr_backport_12sp5

Conversation

@taroth21
Copy link
Copy Markdown
Contributor

@taroth21 taroth21 commented Apr 7, 2026

PR creator: Description

Backports the changes from #1878 to this branch, using a dedicated python script, db5metasync, by @tomschr. The script lives in one of our internal repositories. It comes with slight side-effects (reformatting individual elements), but that cannot be avoided unfortunately.

PR creator: Which product versions do the changes apply to?

When opening a PR, check all versions of the documentation that your PR applies to.

  • SLE 15/openSUSE Leap 15.x

    • SLE 15 SP7/openSUSE Leap 15.7 (current main, no backport necessary)
    • SLE 15 SP6/openSUSE Leap 15.6
    • SLE 15 SP5/openSUSE Leap 15.5
    • SLE 15 SP4/openSUSE Leap 15.4
    • SLE 15 SP3/openSUSE Leap 15.3
  • SLE 12

    • SLE 12 SP5

PR reviewer: Checklist

The doc team member merging your PR will take care of the following tasks and will tick the boxes if done.

@taroth21
Copy link
Copy Markdown
Contributor Author

taroth21 commented Apr 7, 2026

Script output:

Processing 262 common files...
[info]: common_intro_acknowl_i.xml created new tag
[info]: common_intro_source_code_i.xml created new tag
[info]: hardening_pam_stack.xml created new tag
[info]: newbie_bash.xml created new tag
[info]: opensuse_reference_intro.xml created new tag
[info]: newbie_bash_commands_i.xml created new tag
[info]: newbie_perm_i.xml created new tag
[info]: opensuse_startup_intro.xml created new tag
[info]: security_vpnserver_yast.xml created new tag
[info]: tuning_utilities_dstat.xml created new tag

--- Sync Summary ---
Total common files processed: 262
Successful: 261
Skipped: 1
- schemas.xml: No description in source
Orphan files in target: 97
- advanced_disksetup.xml
- apps_brasero.xml
- apps_empathy.xml
- apps_gftp.xml
- art_apparmor_quick.xml
- art_gnome_quick.xml
- art_kgraft.xml
- art_opensuse_install_quick.xml
- art_pcidss.xml
- art_sle_amazon_ecs.xml
- art_sle_install_quick.xml
- art_sles_rpi_quick.xml
- ay_bigfile.xml
- book_gnomeuser.xml
- book_opensuse_reference.xml
- book_opensuse_startup.xml
- book_quickstarts.xml
- book_sle_admin.xml
- book_sle_deployment.xml
- book_sle_tuning.xml
- book_sle_virtualization.xml
- book_sles_docker.xml
- book_sles_kvm.xml
- book_sles_smt.xml
- book_sles_storage.xml
- common_docupdates_ga_i.xml
- common_docupdates_sp1_i.xml
- common_docupdates_sp2_i.xml
- common_docupdates_sp3_i.xml
- common_docupdates_sp3_maint1_i.xml
- common_gfdl1.2_i.xml
- containers_basics.xml
- deployment_prep_aarch64_makeavail.xml
- deployment_prep_aarch64_workflow.xml
- deployment_prep_boot.xml
- deployment_prep_power_info.xml
- deployment_prep_power_preparing.xml
- deployment_prep_power_requirements.xml
- deployment_prep_x86_makeavail.xml
- deployment_prep_x86_workflow.xml
- docker_building_images.xml
- docker_containers.xml
- docker_dockerizing_application.xml
- docker_installation.xml
- docker_overview.xml
- docker_registry.xml
- docker_sle2docker.xml
- docker_troubleshoot.xml
- gnome_admin.xml
- hardening.xml
- image_kiwi.xml
- image_kiwi_pointer.xml
- image_studio_pointer.xml
- inst_yast2.xml
- kgraft.xml
- kvm_appendix.xml
- kvm_limitations.xml
- kvm_support_status.xml
- libvirt_configuration.xml
- libvirt_networking.xml
- lvm.xml
- net_nfs.xml
- pcmcia_apm.xml
- qemu_kvm_cache_modes.xml
- raid.xml
- security_ldap_kerberos_ad_yast.xml
- security_policy_kit.xml
- security_yast2_ca.xml
- smt_advanced.xml
- smt_appendix_api.xml
- smt_authors.xml
- smt_certificates.xml
- smt_client.xml
- smt_config_files.xml
- smt_install.xml
- smt_management.xml
- smt_mirroring.xml
- smt_overview.xml
- smt_product_overview.xml
- smt_registration.xml
- smt_reporting.xml
- smt_scripts.xml
- smt_server.xml
- smt_tools.xml
- storage_iscsi-lio.xml
- storage_nfs-acl.xml
- storage_troubleshooting.xml
- storage_whatsnew.xml
- tuning_perfmon.xml
- update_split_brain.xml
- vt_best_practices.xml
- xen2kvm_quick.xml
- xen_guest_suse.xml
- xen_intro.xml
- yast2_hw.xml
- yast2_manpart.xml
- yast2_sw_addon.xml
Orphan files in source: 200
- MAIN.SLE-Micro.xml
- administration_intro.xml
- art-kubevirt.xml
- art-nvidia-vgpu.xml
- art_admin_slemicro_cockpit.xml
- art_admin_slemicro_podman.xml
- art_admin_slemicro_selinux.xml
- art_installation-sleds.xml
- art_modules.xml
- art_raspberry-pi.xml
- art_virtualization-best-practices.xml
- ay_12_migrate_15.xml
- ay_apache_server.xml
- ay_ask_user_values.xml
- ay_audit_framework.xml
- ay_auth_client.xml
- ay_auto_installation.xml
- ay_complete_configurations.xml
- ay_configuration_installation_options.xml
- ay_configuration_management.xml
- ay_control_file.xml
- ay_country_settings.xml
- ay_create_control_file.xml
- ay_custom_user_scripts.xml
- ay_dhcp_server.xml
- ay_dns_server.xml
- ay_dynamic_profiles.xml
- ay_erb_templates.xml
- ay_faq.xml
- ay_fiber_channel.xml
- ay_firewall.xml
- ay_firstboot.xml
- ay_ftp_server.xml
- ay_general_options.xml
- ay_grub_bootloader.xml
- ay_handling_rules.xml
- ay_hardware.xml
- ay_hosts.xml
- ay_import_ssh.xml
- ay_intro.xml
- ay_introduction.xml
- ay_iscsi_client.xml
- ay_kernel_dumps.xml
- ay_linuxrc_options.xml
- ay_mail_server.xml
- ay_networking.xml
- ay_nfs.xml
- ay_nis_client.xml
- ay_nis_server.xml
- ay_ntp_client.xml
- ay_partitioning.xml
- ay_pre_scripts.xml
- ay_proxy.xml
- ay_registration_extensions.xml
- ay_reporting.xml
- ay_rules_classes.xml
- ay_running_system.xml
- ay_samba_server.xml
- ay_security_settings.xml
- ay_services_targets.xml
- ay_software.xml
- ay_squid_server.xml
- ay_sysconfig.xml
- ay_systemd_bootloader.xml
- ay_tftp_server.xml
- ay_upgrade.xml
- ay_users_groups.xml
- ay_windows_domain_client.xml
- book_admin_slemicro.xml
- book_administration.xml
- book_autoyast.xml
- book_deployment.xml
- book_deployment_slemicro.xml
- book_gnome-user.xml
- book_reference-opensuse.xml
- book_rmt.xml
- book_security_slemicro.xml
- book_startup-opensuse.xml
- book_storage.xml
- book_tuning.xml
- book_upgrade.xml
- book_upgrade_slemicro.xml
- book_virtualization.xml
- chrony.xml
- common_authors.xml
- common_criteria.xml
- create-os-image.xml
- deployment_boot_parameters.xml
- deployment_customize_installation_image.xml
- deployment_expert_partitioner.xml
- deployment_expert_partitioner_encryption.xml
- deployment_expert_partitioner_lvm.xml
- deployment_expert_partitioner_overview.xml
- deployment_expert_partitioner_raid.xml
- deployment_hypervisors.xml
- deployment_images_combustion.xml
- deployment_images_description.xml
- deployment_images_ignition.xml
- deployment_images_procedure.xml
- deployment_kernelupdate.xml
- deployment_manual_installation.xml
- deployment_master_cleanup.xml
- deployment_mksusecd.xml
- deployment_postinstall_slemicro.xml
- deployment_prep_aarch64_media.xml
- deployment_prep_aarch64_raspi.xml
- deployment_prep_x86_media.xml
- deployment_prep_x86_slemicroreq.xml
- deployment_prep_zseries_prep_io_auto_config.xml
- deployment_prep_zseries_prep_secure_boot.xml
- deployment_prep_zseries_requirements.xml
- deployment_pxe.xml
- deployment_register.xml
- deployment_selfinstall_procedure.xml
- deployment_troubleshooting.xml
- deployment_yast_installer.xml
- file_management.xml
- gpu_passthru.xml
- installation-opensuse.xml
- klp.xml
- libvirt_configuration_gui.xml
- libvirt_host.xml
- physical_security.xml
- podman_terminology.xml
- powermanagement.xml
- pv2fv.xml
- rmt_backup.xml
- rmt_certificates.xml
- rmt_client.xml
- rmt_config_files.xml
- rmt_install.xml
- rmt_intro.xml
- rmt_migrate_from_smt.xml
- rmt_mirroring.xml
- rmt_overview.xml
- rmt_public_cloud.xml
- rmt_rmt-cli.xml
- rmt_systemd.xml
- rmt_tools.xml
- security_cron_at.xml
- security_cryptctl.xml
- security_freeradius.xml
- security_ldap_active_directory_sync.xml
- security_ldap_backups.xml
- security_ldap_ca.xml
- security_ldap_directory_tree.xml
- security_ldap_docker_container.xml
- security_ldap_firewall.xml
- security_ldap_install.xml
- security_ldap_migrate_test.xml
- security_ldap_modules.xml
- security_ldap_replication.xml
- security_ldap_sssd.xml
- security_ldap_users.xml
- security_polkit.xml
- security_stig.xml
- security_sysctl.xml
- security_xca.xml
- security_xforwarding.xml
- sle_update_finish.xml
- sle_update_preparation.xml
- slemicro_health_checker.xml
- slemicro_introduction.xml
- slemicro_nm_configuration.xml
- slemicro_nm_vs_wicked.xml
- slemicro_pam_login.xml
- slemicro_pcp.xml
- slemicro_read-only_fs.xml
- slemicro_security_attestation.xml
- slemicro_security_selinux.xml
- slemicro_snapshots.xml
- slemicro_supportconfig.xml
- slemicro_toolbox.xml
- slemicro_transactional_updates.xml
- slemicro_update_preparation.xml
- slemicro_update_procedure.xml
- slemicro_zypper.xml
- software_management.xml
- storage_nfs.xml
- storage_raid_troubleshooting.xml
- transactional_updates.xml
- tuning_dynamic_debug.xml
- tuning_sapconf.xml
- tuning_tuned.xml
- uefi-httpboot-server.xml
- ulp.xml
- update-alternatives.xml
- updater_gnome_sw.xml
- upgrade_intro.xml
- user_management.xml
- virt-crash-dump.xml
- virt_help.xml
- virt_logs.xml
- vm_security.xml
- vt_qemu_ga.xml
- vt_qemu_tpm.xml
- vt_scenarios.xml
- xen2kvm.xml
- yast2_serviceman.xml
- zseries_boot_new_kernel.xml

@taroth21
Copy link
Copy Markdown
Contributor Author

taroth21 commented Apr 7, 2026

ToDo: add meta descriptions for the following chapter files:

  • advanced_disksetup.xml
  • apps_brasero.xml
  • apps_empathy.xml
  • apps_gftp.xml
  • containers_basics.xml
  • deployment_prep_boot.xml
  • docker_building_images.xml
  • docker_containers.xml
  • docker_dockerizing_application.xml
  • docker_installation.xml
  • docker_overview.xml
  • docker_registry.xml
  • docker_sle2docker.xml
  • docker_troubleshoot.xml
  • gnome_admin.xml
  • image_kiwi.xml
  • image_kiwi_pointer.xml
  • image_studio_pointer.xml
  • inst_yast2.xml
  • kgraft.xml
  • kvm_appendix.xml
  • kvm_limitations.xml
  • kvm_support_status.xml
  • libvirt_configuration.xml
  • libvirt_networking.xml
  • net_nfs.xml
  • pcmcia_apm.xml
  • security_policy_kit.xml
  • security_yast2_ca.xml
  • smt_advanced.xml
  • smt_client.xml
  • smt_install.xml
  • smt_management.xml
  • smt_mirroring.xml
  • smt_overview.xml
  • smt_product_overview.xml
  • smt_registration.xml
  • smt_reporting.xml
  • smt_server.xml
  • smt_tools.xml
  • storage_iscsi-lio.xml
  • storage_nfs-acl.xml
  • storage_troubleshooting.xml
  • tuning_perfmon.xml
  • xen_intro.xml
  • xen_guest_suse.xml
  • yast2_hw.xml
  • yast2_sw_addon.xml

@taroth21 taroth21 requested a review from dariavladykina April 9, 2026 10:00
@taroth21
Copy link
Copy Markdown
Contributor Author

taroth21 commented Apr 9, 2026

@dariavladykina : Please review the newly generated meta descriptions for the files listed in #1914 (comment).

The other meta descriptions are backports from main (see the PR description) and have been reviewed by you before.

Unfortunately all (but the manually backported meta descriptions for the AutoYaST Guide) are lacking the attribute its:translate="yes" currently. We will fix that flaw after your review has been done.

Thanks in advance!

Copy link
Copy Markdown
Collaborator

@dariavladykina dariavladykina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @taroth21, I've gone through all the files from PR #1914 (comment) and added the tags to them. Thanks!

Comment thread xml/ay_bigfile.xml Outdated
Comment thread xml/apps_pidgin.xml
<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-pidgin">
<title>Pidgin: Instant Messaging</title>
<info>
<meta name="description">Master the features of Pidgin's instant messaging interface to communicate efficiently in real time with online contacts across various networks and protocols</meta>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<meta name="description">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">Master Pidgins instant messaging interface to communicate efficiently in real time across multiple networks and protocols</meta>

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied to main branch instead

Comment thread xml/audit_components.xml
<title>Understanding Linux Audit</title>
<info>
<abstract>
<meta name="description">Learn how to configure and utilize the Linux audit framework for secure, real-time event collection and policy evaluation with this guide</meta>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<meta name="description">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">Learn how to configure and use the Linux audit framework for secure, real-time event collection and policy evaluation with this guide</meta>

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied to main branch instead

Comment thread xml/book_quickstarts.xml Outdated
Comment thread xml/containers_basics.xml Outdated
Comment thread xml/xen_guest_suse.xml Outdated
-->
<title>SUSE Linux Virtual Machines</title>
<info>
<meta name="description">Learn how to install and update SUSE Linux virtual machines on Xen by configuring add-on products and network installation sources for your guests</meta>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<meta name="description">Learn how to install and update SUSE Linux virtual machines on Xen by configuring add-on products and network installation sources for your guests</meta>
<meta name="description" its:translate="yes">Learn how to install and update SUSE Linux virtual machines on Xen by configuring add-on products and network installation sources for your guests</meta>

Comment thread xml/yast2_hw.xml Outdated
@@ -7,6 +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" version="5.0" xml:id="cha-y2-hw">
<title>Setting Up Hardware Components with &yast;</title>
<info>
<meta name="description">Learn how to configure essential hardware components including audio devices, printers, and scanners using the YaST setup modules on your system</meta>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<meta name="description">Learn how to configure essential hardware components including audio devices, printers, and scanners using the YaST setup modules on your system</meta>
<meta name="description" its:translate="yes">Learn how to configure essential hardware components including audio devices, printers, and scanners using the YaST setup modules on your system</meta>

Comment thread xml/yast2_hw.xml Outdated
@@ -7,6 +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" version="5.0" xml:id="cha-y2-hw">
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<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-y2-hw">
<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-y2-hw">

Comment thread xml/yast2_sw_addon.xml Outdated
@@ -7,6 +7,15 @@
<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-add-ons">
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<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-add-ons">
<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-add-ons">

Comment thread xml/yast2_sw_addon.xml Outdated
@@ -7,6 +7,15 @@
<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-add-ons">
<title>Installing Modules, Extensions, and Third Party Add-On Products</title>
<info>
<meta name="description">Install and manage system modules, extensions, and third-party add-on products using YaST to enhance functionality and customize your Linux environment</meta>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<meta name="description">Install and manage system modules, extensions, and third-party add-on products using YaST to enhance functionality and customize your Linux environment</meta>
<meta name="description" its:translate="yes">Install and manage system modules, extensions, and third-party add-on products using YaST to enhance functionality and customize your Linux environment</meta>

Copy link
Copy Markdown
Collaborator

@dariavladykina dariavladykina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @taroth21, I've gone through all the files from PR #1914 (comment) and added the tags to them. Thanks!

taroth21 and others added 3 commits April 14, 2026 10:43
Co-authored-by: Daria Vladykina <daria.vladykina@suse.com>
Co-authored-by: Daria Vladykina <daria.vladykina@suse.com>
taroth21 added a commit that referenced this pull request Apr 14, 2026
- apply Daria's suggestions from #1914
  that are also valid for 'main'
- start to add meta descriptions to book parts (WIP)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants