diff --git a/titles/about/docinfo.xml b/titles/about/docinfo.xml
index 3dceb13718..5f7fe2ebac 100644
--- a/titles/about/docinfo.xml
+++ b/titles/about/docinfo.xml
@@ -1,11 +1,11 @@
-
About {product}
+{title}
{product}
{product-version}
-Introduction to {product}
+{subtitle}
- {product} is a developer platform designed to build developer portals. Use {product} to provide a streamlined development environment with a centralized software catalog to build high-quality software efficiently.
+ {abstract}
{company-name} Customer Content Services
-
\ No newline at end of file
+
diff --git a/titles/about/master.adoc b/titles/about/master.adoc
index 94a8f089e1..0d00cfa9d1 100644
--- a/titles/about/master.adoc
+++ b/titles/about/master.adoc
@@ -2,8 +2,8 @@
include::artifacts/attributes.adoc[]
:imagesdir: images
:title: About {product}
-:subtitle: Introduction to {product}
-:abstract: {product} is a developer platform designed to build developer portals. Use {product} to provide a streamlined development environment with a centralized software catalog to build high-quality software efficiently.
+: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.
include::assemblies/assembly-about-rhdh.adoc[]
diff --git a/titles/admin-rhdh/title-admin.adoc b/titles/admin-rhdh/title-admin.adoc
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/titles/audit-log/master.adoc b/titles/audit-log/master.adoc
index 066a02fe15..b836359233 100644
--- a/titles/audit-log/master.adoc
+++ b/titles/audit-log/master.adoc
@@ -1,10 +1,9 @@
include::artifacts/attributes.adoc[]
:context: title-audit-log
:imagesdir: images
-:title: Audit log
+: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.
-
= {title}
// Audit logging
diff --git a/titles/authentication/master.adoc b/titles/authentication/master.adoc
index 9c4afeb354..0db027bd0c 100644
--- a/titles/authentication/master.adoc
+++ b/titles/authentication/master.adoc
@@ -1,7 +1,7 @@
include::artifacts/attributes.adoc[]
:context: title-authentication
:imagesdir: images
-:title: Authentication
+: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.
//[id="{context}"]
diff --git a/titles/authorization/master.adoc b/titles/authorization/master.adoc
index f864dbbf0d..1ac9860e0d 100644
--- a/titles/authorization/master.adoc
+++ b/titles/authorization/master.adoc
@@ -1,7 +1,7 @@
include::artifacts/attributes.adoc[]
:context: title-authorization
:imagesdir: images
-:title: Authorization
+:title: Authorization in {product}
:subtitle: Configuring authorization by using role based access control (RBAC) in {product}
:abstract: As a {product} platform engineer, you can manage authorizations of other users by using role based access control (RBAC) to meet the specific needs of your organization.
//[id="{context}"]
diff --git a/titles/configuring/master.adoc b/titles/configuring/master.adoc
index 82b772f476..edce24bba2 100644
--- a/titles/configuring/master.adoc
+++ b/titles/configuring/master.adoc
@@ -1,6 +1,6 @@
include::artifacts/attributes.adoc[]
-:title: Configuring
-:subtitle: Configuring {product}
+: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.
:context: configuring-and-operating
[id="{context}"]
diff --git a/titles/customizing/master.adoc b/titles/customizing/master.adoc
index 869c0b6da2..838b8d5b2d 100644
--- a/titles/customizing/master.adoc
+++ b/titles/customizing/master.adoc
@@ -1,7 +1,7 @@
include::artifacts/attributes.adoc[]
-:title: Customizing
-:subtitle: Customizing {product}
-:abstract: Learn to customize {product}, such as templates, learning paths, tech docs, tech radar, home page, quick access cards, and appearance.
+: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.
:context: customizing-display
[id="{context}"]
= {title}
diff --git a/titles/install-rhdh-air-gapped/docinfo.xml b/titles/install-rhdh-air-gapped/docinfo.xml
index f86cb562a6..0d03200f03 100644
--- a/titles/install-rhdh-air-gapped/docinfo.xml
+++ b/titles/install-rhdh-air-gapped/docinfo.xml
@@ -1,10 +1,9 @@
-Installing {product} in an air-gapped environment
+{title}
{product}
{product-version}
-
-
+{subtitle}
- {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 an air-gapped {product-short} instance on any supported platform using either the Operator or Helm chart.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/install-rhdh-air-gapped/master.adoc b/titles/install-rhdh-air-gapped/master.adoc
index fe3c12095a..7ef00cf127 100644
--- a/titles/install-rhdh-air-gapped/master.adoc
+++ b/titles/install-rhdh-air-gapped/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-air-grapped"]
include::artifacts/attributes.adoc[]
-= Installing {product} in an air-gapped environment
+: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.
+= {title}
:context: title-install-rhdh-air-grapped
:imagesdir: images
diff --git a/titles/install-rhdh-aks/docinfo.xml b/titles/install-rhdh-aks/docinfo.xml
index 563695acbe..e7fae0f66e 100644
--- a/titles/install-rhdh-aks/docinfo.xml
+++ b/titles/install-rhdh-aks/docinfo.xml
@@ -1,10 +1,10 @@
-Installing {product} on {aks-brand-name}
+{title}
{product}
{product-version}
-
+{subtitle}
- {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.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/install-rhdh-aks/master.adoc b/titles/install-rhdh-aks/master.adoc
index f04de833c2..f8a00fc926 100644
--- a/titles/install-rhdh-aks/master.adoc
+++ b/titles/install-rhdh-aks/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-aks"]
include::artifacts/attributes.adoc[]
-= Installing {product} on {aks-brand-name}
+: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.
+= {title}
:context: title-install-rhdh-aks
:imagesdir: images
diff --git a/titles/install-rhdh-eks/docinfo.xml b/titles/install-rhdh-eks/docinfo.xml
index b1a2c5d42f..35491c93fe 100644
--- a/titles/install-rhdh-eks/docinfo.xml
+++ b/titles/install-rhdh-eks/docinfo.xml
@@ -1,13 +1,11 @@
-Installing {product} on {eks-brand-name}
+{title}
{product}
{product-version}
-
-
+{subtitle}
- {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 {eks-brand-name} ({eks-short}) using either the Operator or Helm chart.
+{abstract}
- {company-name} Customer Content Services
+{company-name} Customer Content Services
-
+
diff --git a/titles/install-rhdh-eks/master.adoc b/titles/install-rhdh-eks/master.adoc
index cb37cf1613..bc93f42610 100644
--- a/titles/install-rhdh-eks/master.adoc
+++ b/titles/install-rhdh-eks/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-eks"]
include::artifacts/attributes.adoc[]
-= Installing {product} on {eks-brand-name}
+: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.
+= {title}
:context: title-install-rhdh-eks
:imagesdir: images
diff --git a/titles/install-rhdh-gke/docinfo.xml b/titles/install-rhdh-gke/docinfo.xml
index 40f0701c84..f2a7a08a87 100644
--- a/titles/install-rhdh-gke/docinfo.xml
+++ b/titles/install-rhdh-gke/docinfo.xml
@@ -1,10 +1,10 @@
Installing {product} on {gke-brand-name}
{product}
{product-version}
-
+{subtitle}
- {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 {gke-brand-name} ({gke-short}) using either the Operator or Helm chart.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/install-rhdh-gke/master.adoc b/titles/install-rhdh-gke/master.adoc
index 94eb52f952..aa80c53583 100644
--- a/titles/install-rhdh-gke/master.adoc
+++ b/titles/install-rhdh-gke/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-gke"]
include::artifacts/attributes.adoc[]
-= Installing {product} on {gke-brand-name}
+: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.
+= {title}
:context: title-install-rhdh-gke
:imagesdir: images
diff --git a/titles/install-rhdh-ocp/docinfo.xml b/titles/install-rhdh-ocp/docinfo.xml
index 329d70fca5..e7fae0f66e 100644
--- a/titles/install-rhdh-ocp/docinfo.xml
+++ b/titles/install-rhdh-ocp/docinfo.xml
@@ -1,10 +1,10 @@
-Installing {product} on {ocp-short}
+{title}
{product}
{product-version}
-
+{subtitle}
- {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 {ocp-brand-name} using either the Operator or Helm chart.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/install-rhdh-ocp/master.adoc b/titles/install-rhdh-ocp/master.adoc
index a3c4500b5a..929755a1ed 100644
--- a/titles/install-rhdh-ocp/master.adoc
+++ b/titles/install-rhdh-ocp/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-ocp"]
include::artifacts/attributes.adoc[]
-= Installing {product} on {ocp-short}
+: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.
+= {title}
:context: title-install-rhdh-ocp
:imagesdir: images
diff --git a/titles/install-rhdh-osd-gcp/docinfo.xml b/titles/install-rhdh-osd-gcp/docinfo.xml
index f56612be77..e7fae0f66e 100644
--- a/titles/install-rhdh-osd-gcp/docinfo.xml
+++ b/titles/install-rhdh-osd-gcp/docinfo.xml
@@ -1,10 +1,10 @@
-Installing {product} on {osd-short} on {gcp-brand-name}
+{title}
{product}
{product-version}
-
+{subtitle}
- {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 {osd-brand-name} on {gcp-brand-name} ({gcp-short}) using either the Operator or Helm chart.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/install-rhdh-osd-gcp/master.adoc b/titles/install-rhdh-osd-gcp/master.adoc
index e90cb661a8..975f2138f0 100644
--- a/titles/install-rhdh-osd-gcp/master.adoc
+++ b/titles/install-rhdh-osd-gcp/master.adoc
@@ -1,6 +1,9 @@
[id="title-install-rhdh-osd-gcp"]
include::artifacts/attributes.adoc[]
-= Installing {product} on {osd-short} on {gcp-brand-name}
+: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.
+= {title}
:context: title-install-rhdh-osd-gcp
:imagesdir: images
diff --git a/titles/installation-rhdh/artifacts b/titles/installation-rhdh/artifacts
deleted file mode 120000
index f30b6dea60..0000000000
--- a/titles/installation-rhdh/artifacts
+++ /dev/null
@@ -1 +0,0 @@
-../../artifacts
\ No newline at end of file
diff --git a/titles/installation-rhdh/assemblies b/titles/installation-rhdh/assemblies
deleted file mode 120000
index 91646274db..0000000000
--- a/titles/installation-rhdh/assemblies
+++ /dev/null
@@ -1 +0,0 @@
-../../assemblies
\ No newline at end of file
diff --git a/titles/installation-rhdh/images b/titles/installation-rhdh/images
deleted file mode 120000
index 5fa6987088..0000000000
--- a/titles/installation-rhdh/images
+++ /dev/null
@@ -1 +0,0 @@
-../../images
\ No newline at end of file
diff --git a/titles/installation-rhdh/modules b/titles/installation-rhdh/modules
deleted file mode 120000
index 8b0e854007..0000000000
--- a/titles/installation-rhdh/modules
+++ /dev/null
@@ -1 +0,0 @@
-../../modules
\ No newline at end of file
diff --git a/titles/plugin-rhdh/docinfo.xml b/titles/plugin-rhdh/docinfo.xml
index e8bc68e50b..80df65a36a 100644
--- a/titles/plugin-rhdh/docinfo.xml
+++ b/titles/plugin-rhdh/docinfo.xml
@@ -1,7 +1,7 @@
Configuring plugins in {product}
{product}
{product-version}
-
+{subtitle}
Red Hat Developer Hub is a developer platform for building developer portals. You can add and configure plugins in {product-short} to access various software development tools.
@@ -9,4 +9,4 @@
Red Hat Customer Content Services
-
\ No newline at end of file
+
diff --git a/titles/plugins-rhdh-about/docinfo.xml b/titles/plugins-rhdh-about/docinfo.xml
index 5fc51a0f23..8383a9fef4 100644
--- a/titles/plugins-rhdh-about/docinfo.xml
+++ b/titles/plugins-rhdh-about/docinfo.xml
@@ -1,7 +1,7 @@
{title}
{product}
{product-version}
-
+{subtitle}
The {product} ({product-very-short}) application offers a unified platform with various plugins. Using the plugin ecosystem within the {product-short} application, you can access your development infrastructure and software development tools.
diff --git a/titles/plugins-rhdh-configure/docinfo.xml b/titles/plugins-rhdh-configure/docinfo.xml
index e4b171f26e..e7fae0f66e 100644
--- a/titles/plugins-rhdh-configure/docinfo.xml
+++ b/titles/plugins-rhdh-configure/docinfo.xml
@@ -1,7 +1,7 @@
{title}
{product}
{product-version}
-
+{subtitle}
{abstract}
diff --git a/titles/plugins-rhdh-configure/master.adoc b/titles/plugins-rhdh-configure/master.adoc
index 1974eabe8f..2977e9c01f 100644
--- a/titles/plugins-rhdh-configure/master.adoc
+++ b/titles/plugins-rhdh-configure/master.adoc
@@ -3,7 +3,7 @@ include::artifacts/attributes.adoc[]
:imagesdir: images
:title: Configuring dynamic plugins
-:subtitle: Configuring dynamic plugins in {product-very-short} as a platform engineer.
+: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.
include::assemblies/dynamic-plugins/assembly-configuring-rhdh-plugins.adoc[]
diff --git a/titles/plugins-rhdh-install/docinfo.xml b/titles/plugins-rhdh-install/docinfo.xml
index e4b171f26e..e7fae0f66e 100644
--- a/titles/plugins-rhdh-install/docinfo.xml
+++ b/titles/plugins-rhdh-install/docinfo.xml
@@ -1,7 +1,7 @@
{title}
{product}
{product-version}
-
+{subtitle}
{abstract}
diff --git a/titles/plugins-rhdh-reference/docinfo.xml b/titles/plugins-rhdh-reference/docinfo.xml
index e4b171f26e..e7fae0f66e 100644
--- a/titles/plugins-rhdh-reference/docinfo.xml
+++ b/titles/plugins-rhdh-reference/docinfo.xml
@@ -1,7 +1,7 @@
{title}
{product}
{product-version}
-
+{subtitle}
{abstract}
diff --git a/titles/plugins-rhdh-reference/master.adoc b/titles/plugins-rhdh-reference/master.adoc
index bcd22f4c9b..2902e446dd 100644
--- 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: Working with plugins in {product-very-short}
+: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.
include::assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc[]
diff --git a/titles/plugins-rhdh-using/docinfo.xml b/titles/plugins-rhdh-using/docinfo.xml
index e4b171f26e..e7fae0f66e 100644
--- a/titles/plugins-rhdh-using/docinfo.xml
+++ b/titles/plugins-rhdh-using/docinfo.xml
@@ -1,7 +1,7 @@
{title}
{product}
{product-version}
-
+{subtitle}
{abstract}
diff --git a/titles/plugins-rhdh-using/master.adoc b/titles/plugins-rhdh-using/master.adoc
index e104b5c88e..7493b761d7 100644
--- a/titles/plugins-rhdh-using/master.adoc
+++ b/titles/plugins-rhdh-using/master.adoc
@@ -1,8 +1,8 @@
include::artifacts/attributes.adoc[]
:context: title-plugins-rhdh-using
:imagesdir: images
-:title: Using dynamic plugins
-:subtitle: Using {product-very-short} plugins as an end-user
+: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.
//[id="{context}"]
//= {title}
diff --git a/titles/rel-notes-rhdh/docinfo.xml b/titles/rel-notes-rhdh/docinfo.xml
index 4c6026ca94..bc4f3ba6aa 100644
--- a/titles/rel-notes-rhdh/docinfo.xml
+++ b/titles/rel-notes-rhdh/docinfo.xml
@@ -3,9 +3,9 @@
{product-version}
{subtitle}
- Red Hat Developer Hub is a developer platform for building developer portals. This document contains release notes for the {product} {product-version}.
+ {abstract}
- Red Hat Customer Content Services
+ {company-name} Customer Content Services
diff --git a/titles/rel-notes-rhdh/title-rhdh-release-notes.adoc b/titles/rel-notes-rhdh/title-rhdh-release-notes.adoc
index defd37350a..5cdd60e777 100644
--- a/titles/rel-notes-rhdh/title-rhdh-release-notes.adoc
+++ b/titles/rel-notes-rhdh/title-rhdh-release-notes.adoc
@@ -1,7 +1,8 @@
[id='title-rhdh-release-notes']
include::artifacts/attributes.adoc[]
-:title: Release notes
+:title: {product} release notes
:subtitle: Release notes for {product} {product-version}
+:abstract: {product} ({product-short}) {product-version} is now generally available. {product-short} is a fully supported, enterprise-grade productized version of upstream Backstage {product-backstage-version}. This document contains release notes for the {product} {product-version}.
= {title}: {subtitle}
:context: release-notes-rhdh
:imagesdir: images
diff --git a/titles/upgrade-rhdh/docinfo.xml b/titles/upgrade-rhdh/docinfo.xml
index 7ad28a1c63..e7fae0f66e 100644
--- a/titles/upgrade-rhdh/docinfo.xml
+++ b/titles/upgrade-rhdh/docinfo.xml
@@ -1,10 +1,10 @@
-Upgrading {product}
+{title}
{product}
{product-version}
-
+{subtitle}
- You can upgrade a {product} instance to a later version from the {ocp-short} web console using either the Operator or the Helm chart.
+ {abstract}
{company-name} Customer Content Services
diff --git a/titles/upgrade-rhdh/master.adoc b/titles/upgrade-rhdh/master.adoc
index 139e770ecf..f8a4f25138 100644
--- a/titles/upgrade-rhdh/master.adoc
+++ b/titles/upgrade-rhdh/master.adoc
@@ -1,8 +1,11 @@
[id="title-upgrade-rhdh"]
include::artifacts/attributes.adoc[]
-= Upgrading {product}
+: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.
:context: title-upgrade-rhdh
:imagesdir: images
+= {title}
include::modules/upgrade/proc-upgrade-rhdh-operator.adoc[leveloffset=+1]