Manual cherrypick (#1275)

pabel-rh · web-flow · commit 592a287b438e · 2025-07-17T16:20:52.000+01:00
diff --git a/titles/about/master.adoc b/titles/about/master.adoc
@@ -2,8 +2,8 @@
 include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: About {product}
-:subtitle: {product} is a customizable developer portal with enterprise-level support and a centralized software catalog that you can use to build high-quality software efficiently in a streamlined development environment.
-:abstract: {product} is a customizable developer portal with enterprise-level support and a centralized software catalog that you can use to build high-quality software efficiently in a streamlined development environment.
+:subtitle: {product} is a customizable developer portal with enterprise-level support and a centralized software catalog that you can use to build high-quality software efficiently in a streamlined development environment
+:abstract: {product} ({product-very-short}) is a customizable developer portal with enterprise-level support and a centralized software catalog that you can use to build high-quality software efficiently in a streamlined development environment.
 
 include::assemblies/assembly-about-rhdh.adoc[]
 
diff --git a/titles/adoption-insights/master.adoc b/titles/adoption-insights/master.adoc
@@ -2,8 +2,8 @@ include::artifacts/attributes.adoc[]
 :context: title-adoption-insights
 :imagesdir: images
 :title: Adoption Insights in {product}
-:subtitle: Delivers detailed analytics on adoption and engagement within your internal developer portal.
-:abstract: As a platform engineer, you can configure Adoption Insights in {product-very-short} to visualize key metrics and trends to get information about the usage of {product-very-short} in your organization.
+:subtitle: Delivering detailed analytics on adoption and engagement within your internal developer portal
+:abstract: As a platform engineer, you can configure Adoption Insights in {product} ({product-very-short}) to visualize key metrics and trends to get information about the usage of {product-very-short} in your organization.
 = {title}
 
 //{product} Adoption Insights (Developer Preview)
diff --git a/titles/audit-log/master.adoc b/titles/audit-log/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Audit logs in {product}
 :subtitle: Tracking user activities, system events, and data changes with {product} audit logs
-:abstract: As a {product} administrator, you can track user activities, system events, and data changes with {product-short} audit logs.
+:abstract: As a {product} ({product-very-short}) administrator, you can track user activities, system events, and data changes with {product-very-short} audit logs.
 = {title}
 
 // Audit logging
diff --git a/titles/authentication/master.adoc b/titles/authentication/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Authentication in {product}
 :subtitle: Configuring authentication to external services in {product}
-:abstract: As a {product} platform engineer, you can manage authentication of other users to meet the specific needs of your organization.
+:abstract: As a {product} ({product-very-short}) platform engineer, you can manage authentication of other users to meet the specific needs of your organization.
 //[id="{context}"]
 //= {title}
 
diff --git a/titles/authorization/master.adoc b/titles/authorization/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Authorization in {product}
 :subtitle: Configuring authorization by using role based access control (RBAC) in {product}
-:abstract: {product} administrators can use role-based access control (RBAC) to manage authorizations of other users.
+:abstract: {product} ({product-very-short}) administrators can use role-based access control (RBAC) to manage authorizations of other users.
 //[id="{context}"]
 //= {title}
 
diff --git a/titles/configuring/master.adoc b/titles/configuring/master.adoc
@@ -1,7 +1,7 @@
 include::artifacts/attributes.adoc[]
 :title: Configuring {product}
-:subtitle: Add custom config maps and secrets to configure your {product} instance to work in your IT ecosystem.
-:abstract: Learn how to configure {product} for production to work in your IT ecosystem by adding custom config maps and secrets.
+:subtitle: Adding custom config maps and secrets to configure your {product} instance to work in your IT ecosystem
+:abstract: Learn how to configure {product} ({product-very-short}) for production to work in your IT ecosystem by adding custom config maps and secrets.
 :context: configuring-and-operating
 [id="{context}"]
 = {title}
diff --git a/titles/customizing/master.adoc b/titles/customizing/master.adoc
@@ -1,7 +1,7 @@
 include::artifacts/attributes.adoc[]
 :title: Customizing {product}
-:subtitle: Customize {product} appearance and features, such as templates, Learning Paths, Tech Radar, Home page, and quick access cards.
-:abstract: Authorized users can customize {product} appearance and features, such as templates, Learning Paths, Tech Radar, Home page, and quick access cards.
+:subtitle: Customizing {product} appearance and features, such as templates, Learning Paths, Tech Radar, Home page, and quick access cards
+:abstract: Authorized users can customize {product} ({product-very-short}) appearance and features, such as templates, Learning Paths, Tech Radar, Home page, and quick access cards.
 :context: customizing-display
 [id="{context}"]
 = {title}
diff --git a/titles/install-rhdh-air-gapped/master.adoc b/titles/install-rhdh-air-gapped/master.adoc
@@ -2,7 +2,7 @@
 include::artifacts/attributes.adoc[]
 :title: Installing {product} in an air-gapped environment
 :subtitle: Running {product} on {ocp-brand-name} in a networik restricted environment by using either the Operator or Helm chart
-:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy an air-gapped {product-short} instance on any supported platform using either the Operator or Helm chart
+:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy an air-gapped {product} ({product-very-short}) instance on any supported platform using either the Operator or Helm chart
 = {title}
 :context: title-install-rhdh-air-grapped
 :imagesdir: images
diff --git a/titles/install-rhdh-aks/master.adoc b/titles/install-rhdh-aks/master.adoc
@@ -1,8 +1,8 @@
 [id="title-install-rhdh-aks"]
 include::artifacts/attributes.adoc[]
 :title: Installing {product} on {aks-brand-name}
-:subtitle: Running {product} on {aks-brand-name} ({aks-short}) by using either the Operator or Helm chart.
-:abstract: {product} is an enterprise-grade platform for building developer portals. Administrative users can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-short} instance on {aks-brand-name} ({aks-short}) using either the Operator or Helm chart.
+:subtitle: Running {product} on {aks-brand-name} ({aks-short}) by using either the Operator or Helm chart
+:abstract: {product} ({product-very-short}) is an enterprise-grade platform for building developer portals. Administrative users can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-very-short} instance on {aks-brand-name} ({aks-short}) using either the Operator or Helm chart.
 = {title}
 :context: title-install-rhdh-aks
 :imagesdir: images
diff --git a/titles/install-rhdh-eks/master.adoc b/titles/install-rhdh-eks/master.adoc
@@ -2,7 +2,7 @@
 include::artifacts/attributes.adoc[]
 :title: Installing {product} on {eks-brand-name}
 :subtitle: Running {product} on {eks-brand-name} ({eks-short}) by using either the Operator or Helm chart
-:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-short} instance on {eks-brand-name} ({eks-short}) using either the Operator or Helm chart.
+:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product} ({product-very-short}) instance on {eks-brand-name} ({eks-short}) using either the Operator or Helm chart.
 = {title}
 :context: title-install-rhdh-eks
 :imagesdir: images
diff --git a/titles/install-rhdh-gke/master.adoc b/titles/install-rhdh-gke/master.adoc
@@ -1,8 +1,8 @@
 [id="title-install-rhdh-gke"]
 include::artifacts/attributes.adoc[]
 :title: Installing {product} on {gke-brand-name}
-:subtitle: Running {product} on {gke-brand-name} ({gke-short}) by using either the Operator or Helm chart.
-:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-short} instance on {gke-brand-name} ({gke-short}) using either the Operator or Helm chart.
+:subtitle: Running {product} on {gke-brand-name} ({gke-short}) by using either the Operator or Helm chart
+:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product} ({product-very-short}) instance on {gke-brand-name} ({gke-short}) using either the Operator or Helm chart.
 = {title}
 :context: title-install-rhdh-gke
 :imagesdir: images
diff --git a/titles/install-rhdh-ocp/master.adoc b/titles/install-rhdh-ocp/master.adoc
@@ -1,8 +1,8 @@
 [id="title-install-rhdh-ocp"]
 include::artifacts/attributes.adoc[]
 :title: Installing {product} on {ocp-short}
-:subtitle: Running {product} on {ocp-brand-name} by using either the Operator or Helm chart.
-:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-short} instance on {ocp-brand-name} using either the Operator or Helm chart.
+:subtitle: Running {product} on {ocp-brand-name} by using either the Operator or Helm chart
+:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product} ({product-very-short}) instance on {ocp-brand-name} using either the Operator or Helm chart.
 = {title}
 :context: title-install-rhdh-ocp
 :imagesdir: images
diff --git a/titles/install-rhdh-osd-gcp/master.adoc b/titles/install-rhdh-osd-gcp/master.adoc
@@ -1,8 +1,8 @@
 [id="title-install-rhdh-osd-gcp"]
 include::artifacts/attributes.adoc[]
 :title: Installing {product} on {osd-short} on {gcp-brand-name}
-:subtitle: Running {product} on {osd-brand-name} by using either the Operator or Helm chart.
-:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product-short} instance on {osd-brand-name} on {gcp-brand-name} ({gcp-short}) using either the Operator or Helm chart.
+:subtitle: Running {product} on {osd-brand-name} by using either the Operator or Helm chart
+:abstract: Platform administrators can configure roles, permissions, and other settings to enable other authorized users to deploy a {product} ({product-very-short}) instance on {osd-brand-name} on {gcp-brand-name} ({gcp-short}) using either the Operator or Helm chart.
 = {title}
 :context: title-install-rhdh-osd-gcp
 :imagesdir: images
diff --git a/titles/monitoring-and-logging/master.adoc b/titles/monitoring-and-logging/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Monitoring and logging
 :subtitle: Tracking performance and capturing insights with monitoring and logging tools in {product}
-:abstract: As a {product} Operations or Project Manager, you can monitor performance and gather insights using {product}'s monitoring and logging tools.
+:abstract: As a {product} ({product-very-short}) Operations or Project Manager, you can monitor performance and gather insights using {product} monitoring and logging tools.
 
 = {title}
 
diff --git a/titles/plugin-rhdh/title-plugin.adoc b/titles/plugin-rhdh/title-plugin.adoc
@@ -4,7 +4,7 @@ include::artifacts/attributes.adoc[]
 :context: plugin-rhdh
 :imagesdir: images
 
-The {product} is an enterprise-grade, integrated developer platform, extended through plugins, that helps reduce the friction and frustration of developers while boosting their productivity.
+{product} ({product-very-short}) is an enterprise-grade, integrated developer platform, extended through plugins, that helps reduce the friction and frustration of developers while boosting their productivity.
 
 //overview
 include::modules/con-rhdh-plugins.adoc[leveloffset=+1]
diff --git a/titles/plugins-rhdh-about/master.adoc b/titles/plugins-rhdh-about/master.adoc
@@ -4,7 +4,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Introduction to plugins
 :subtitle: Introduction to {product-very-short} plugins
-:abstract: As a {product} user, you can learn about {product} plugins.
+:abstract: As a {product} ({product-very-short}) user, you can learn about {product-very-short} plugins.
 
 = Introduction to plugins
 include::modules/dynamic-plugins/con-rhdh-plugins.adoc[leveloffset=+1]
diff --git a/titles/plugins-rhdh-configure/master.adoc b/titles/plugins-rhdh-configure/master.adoc
@@ -4,6 +4,6 @@ include::artifacts/attributes.adoc[]
 
 :title: Configuring dynamic plugins
 :subtitle: Configuring dynamic plugins in {product}
-:abstract: As a platform engineer, you can configure dynamic plugins in {product-very-short} to access your development infrastructure or software development tools.
+:abstract: As a platform engineer, you can configure dynamic plugins in {product} ({product-very-short}) to access your development infrastructure or software development tools.
 
 include::assemblies/dynamic-plugins/assembly-configuring-rhdh-plugins.adoc[]
diff --git a/titles/plugins-rhdh-install/master.adoc b/titles/plugins-rhdh-install/master.adoc
@@ -4,7 +4,7 @@ include::artifacts/attributes.adoc[]
 
 :title: Installing and viewing plugins in {product}
 :subtitle: Installing plugins in {product}
-:abstract: Administrative users can install and configure plugins to enable other users to use plugins to extend {product-very-short} functionality.
+:abstract: Administrative users can install and configure plugins to enable other users to use plugins to extend {product} ({product-very-short}) functionality.
 
 = {title}
 
diff --git a/titles/plugins-rhdh-reference/master.adoc b/titles/plugins-rhdh-reference/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 
 :title: Dynamic plugins reference
-:subtitle: {product} is preinstalled with a selection of dynamic plugins that you can enable and configure to extend {product-short} functionality
-:abstract: {product} is preinstalled with a selection of dynamic plugins that users can enable and configure to extend {product-very-short} functionality.
+:subtitle: {product} is preinstalled with a selection of dynamic plugins that you can enable and configure to extend {product-very-short} functionality
+:abstract: {product} ({product-very-short}) is preinstalled with a selection of dynamic plugins that users can enable and configure to extend {product-very-short} functionality.
 
 include::assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc[]
diff --git a/titles/plugins-rhdh-troubleshooting/master.adoc b/titles/plugins-rhdh-troubleshooting/master.adoc
@@ -2,8 +2,8 @@ include::artifacts/attributes.adoc[]
 :context: title-plugins-rhdh-about
 :imagesdir: images
 :title: Troubleshooting {product} plugins
-:subtitle: Troubleshooting {product-very-short} plugins
-:abstract: This document describes how to resolve common problems with {product}.
+:subtitle: Troubleshooting {product} plugins
+:abstract: This document describes how to resolve common problems with {product} ({product-very-short}).
 //[id="{context}"]
 //= {title}
 
diff --git a/titles/plugins-rhdh-using/master.adoc b/titles/plugins-rhdh-using/master.adoc
@@ -2,8 +2,8 @@ include::artifacts/attributes.adoc[]
 :context: title-plugins-rhdh-using
 :imagesdir: images
 :title: Using dynamic plugins in {product}
-:subtitle: Using {product} plugins to access your development infrastructure and software development tools.
-:abstract: The following sections provide information about how you can use {product-very-short} dynamic plugins.
+:subtitle: Using {product} plugins to access your development infrastructure and software development tools
+:abstract: The following sections provide information about how you can use {product} ({product-very-short}) dynamic plugins.
 //[id="{context}"]
 //= {title}
 
diff --git a/titles/techdocs/docinfo.xml b/titles/techdocs/docinfo.xml
@@ -1,9 +1,9 @@
 <title>TechDocs for {product}</title>
 <productname>{product}</productname>
 <productnumber>{product-version}</productnumber>
-<subtitle>Use the TechDocs plugin to read and manage your team's technical documentation in one place. Further enhance and customize your TechDocs experience with add-ons.</subtitle>
+<subtitle>Using TechDocs plugin to read and manage your team's technical documentation in one place. Further enhance and customize your TechDocs experience with add-ons</subtitle>
 <abstract>
-    <para>Your organization can use the built-in TechDocs plugin for {product} to create, find, and use technical documentation in a central location and in a standardized way. Documentation files are stored alongside your code and rendered in the Docs tab. Use supported TechDocs add-ons, or create your own, to further enhance your documentation experience.</para>
+    <para>Your organization can use the built-in TechDocs plugin for {product} ({product-very-short}) to create, find, and use technical documentation in a central location and in a standardized way. Documentation files are stored alongside your code and rendered in the Docs tab. Use supported TechDocs add-ons, or create your own, to further enhance your documentation experience.</para>
 </abstract>
 <authorgroup>
     <orgname>{company-name} Customer Content Services</orgname>
diff --git a/titles/telemetry/master.adoc b/titles/telemetry/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
 :imagesdir: images
 :title: Telemetry data collection and analysis
 :subtitle: Collecting and analyzing web analytics and system observability data to enhance {product} experience
-:abstract: As a {product} administrator, you can collect and analyze two distinct types of telemetry data: web analytics using Segment and system observability using OpenTelemetry, to enhance the {product} experience.
+:abstract: As a {product} ({product-very-short}) administrator, you can collect and analyze two distinct types of telemetry data: web analytics using Segment and system observability using OpenTelemetry, to enhance the {product} experience.
 
 = {title}
 
diff --git a/titles/upgrade-rhdh/master.adoc b/titles/upgrade-rhdh/master.adoc
@@ -1,8 +1,8 @@
 [id="title-upgrade-rhdh"]
 include::artifacts/attributes.adoc[]
 :title: Upgrading {product}
-:subtitle: Upgrading a {product} instance to a later version by using either the Operator or the Helm chart
-:abstract: You can upgrade a {product} instance to a later version from the {ocp-short} web console using either the Operator or the Helm chart.
+:subtitle: Upgrading a {product} instance to a later version by using either the Operator or Helm chart
+:abstract: You can upgrade a {product} ({product-very-short}) instance to a later version from the {ocp-short} web console using either the Operator or Helm chart.
 :context: title-upgrade-rhdh
 :imagesdir: images
 = {title}
