Merge branch 'release-1.3' into release-1.3

Author: hmanwani-rh

.github/workflows/build-asciidoc.yml

@@ -17,7 +17,7 @@ name: GitHub Pages
 
 on:
   push:
-    branches: 
+    branches:
     - main
     - rhdh-1.**
     - 1.**.x
@@ -41,14 +41,14 @@ jobs:
       run: |
         # update
         sudo apt-get update -y || true
-        # install 
-        sudo apt-get -y -q install asciidoctor && asciidoctor --version
+        # install
+        sudo apt-get -y -q install podman && podman --version
         echo "GIT_BRANCH=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_ENV
 
     - name: Build guides and indexes
       run: |
         echo "Building branch ${{ env.GIT_BRANCH }}"
-        build/scripts/build.sh -b ${{ env.GIT_BRANCH }}
+        build/scripts/build-ccutil.sh -b ${{ env.GIT_BRANCH }}
 
     # repo must be public for this to work
     - name: Deploy
@@ -60,7 +60,7 @@ jobs:
         keep_files: true
         publish_dir: ./titles-generated
 
-    - name: Cleanup merged PR branches 
+    - name: Cleanup merged PR branches
       run: |
         PULL_URL="https://api.github.com/repos/redhat-developer/red-hat-developers-documentation-rhdh/pulls"
         GITHUB_TOKEN="${{ secrets.RHDH_BOT_TOKEN }}"
@@ -70,7 +70,7 @@ jobs:
         git checkout gh-pages; git pull || true
         dirs=$(find . -maxdepth 1 -name "pr-*" -type d | sed -r -e "s|^\./pr-||")
         refs=$(cat pulls.html | grep pr- | sed -r -e "s|.+.html>pr-([0-9]+)</a>.+|\1|")
-        for d in $(echo -e "$dirs\n$refs" | sort -uV); do 
+        for d in $(echo -e "$dirs\n$refs" | sort -uV); do
           PR="${d}"
           echo -n "Check merge status of PR $PR ... "
           PR_JSON=$(curl -sSL -H "Accept: application/vnd.github+json" -H "Authorization: Bearer $GITHUB_TOKEN" "$PULL_URL/$PR")

artifacts/attributes.adoc

@@ -11,24 +11,28 @@
 :product-short: Developer Hub
 :product-very-short: RHDH
 :product-version: 1.3
-:product-bundle-version: 1.3.0
-:product-chart-version: 1.3.0
+:product-bundle-version: 1.3.1
+:product-chart-version: 1.3.1
 :product-backstage-version: 1.29.2
 :rhdeveloper-name: Red Hat Developer
 :rhel: Red Hat Enterprise Linux
 :odf-name: OpenShift Data Foundation
 
+:my-product-url: https://__<my_developer_hub_url>__
+
 // Red Hat Platforms
 :ocp-brand-name: Red Hat OpenShift Container Platform
 :ocp-short: OpenShift Container Platform
 :ocp-very-short: RHOCP
 :osd-brand-name: Red Hat OpenShift Dedicated
 :osd-short: OpenShift Dedicated
 // minimum and current latest supported versions
-:ocp-version-min: 4.12
-:ocp-version: 4.15
+:ocp-version-min: 4.14
+:ocp-version: 4.16
 // First mention of OpenShift CLI or `oc` in a module
 :openshift-cli: pass:quotes[OpenShift CLI (`oc`)]
+:rhsso-brand-name: Red Hat Single-Sign On
+:rhsso: RHSSO
 
 // Partner Platforms
 :aws-brand-name: Amazon Web Services
@@ -76,7 +80,6 @@
 :installing-and-viewing-dynamic-plugins-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/installing_and_viewing_dynamic_plugins/index
 :installing-and-viewing-dynamic-plugins-title: Installing and viewing dynamic plugins
 
-
 :authentication-book-url: https://docs.redhat.com/documentation/en-us/red_hat_developer_hub/{product-version}/html-single/authentication/index
 :authentication-book-title: Authentication
 
@@ -99,4 +102,4 @@
 :upgrading-book-title: Upgrading {product}
 
 :plugins-configure-book-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html/configuring_dynamic_plugins/index
-:plugins-configure-book-title: Configuring dynamic plugins
+:plugins-configure-book-title: Configuring dynamic plugins

artifacts/rhdh-plugins-reference/tekton/tekton-plugin-admin.adoc

@@ -7,9 +7,7 @@ You can use the Tekton plugin to visualize the results of CI/CD pipeline runs on
 == Installation
 
 .Prerequsites
-* You have installed and configured the `@backstage/plugin-kubernetes` and `@backstage/plugin-kubernetes-backend` dynamic plugins.
-//For more information about installing dynamic plugins, see xref:rhdh-installing-dynamic-plugins[].
-//Cannot xref across titles. Convert xref to a link.
+* You have installed and configured the `@backstage/plugin-kubernetes` and `@backstage/plugin-kubernetes-backend` dynamic plugins. For more information about installing dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}].
 
 * You have configured the Kubernetes plugin to connect to the cluster using a `ServiceAccount`.
 

artifacts/rhdh-plugins-reference/tekton/tekton-plugin-readme.adoc

@@ -9,9 +9,7 @@ You can use the Tekton plugin to visualize the results of CI/CD pipeline runs on
 === Installation
 
 .Prerequsites
-* You have installed and configured the `@backstage/plugin-kubernetes` and `@backstage/plugin-kubernetes-backend` dynamic plugins.
-//For more information about installing dynamic plugins, see xref:rhdh-installing-dynamic-plugins[].
-//Cannot xref across titles. Convert xref to a link.
+* You have installed and configured the `@backstage/plugin-kubernetes` and `@backstage/plugin-kubernetes-backend` dynamic plugins. For more information about installing dynamic plugins, see link:{installing-and-viewing-dynamic-plugins-url}[{installing-and-viewing-dynamic-plugins-title}].
 
 * You have configured the Kubernetes plugin to connect to the cluster using a `ServiceAccount`.
 

artifacts/snip-customer-support-info.adoc

@@ -5,4 +5,4 @@
 If you experience difficulty with a procedure described in this documentation, visit the http://access.redhat.com[Red Hat Customer Portal]. You can use the Red Hat Customer Portal for the following purposes:
 
 * To search or browse through the Red Hat Knowledgebase of technical support articles about Red Hat products. 
-* To create a https://access.redhat.com/support/cases/#/case/new/get-support?caseCreate=true[support case] for Red Hat Global Support Services (GSS). For support case creation, select *Red Hat Developer Hub* as the product and select the appropriate product version.
+* To create a https://access.redhat.com/support/cases/#/case/new/get-support?caseCreate=true[support case] for {company-name} Global Support Services (GSS). For support case creation, select *{product}* as the product and select the appropriate product version. For detailed information about supported platforms, see link:{release-notes-url}#con-release-notes-overview.adoc[Supported Platforms] and the link:https://access.redhat.com/support/policy/updates/developerhub[{product} Life Cycle].

artifacts/snip-technology-preview.adoc

@@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+These features are for Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
+
+For more information on Red Hat Technology Preview features, see https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Scope].
+====

assemblies/assembly-about-rhdh.adoc

@@ -0,0 +1,22 @@
+ifdef::context[:parent-context-of-about-rhdh: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="about-rhdh"]
+endif::[]
+ifdef::context[]
+[id="about-rhdh_{context}"]
+endif::[]
+= About {product}
+
+:context: about-rhdh
+
+{product} is a fully supported, open developer platform that reduces friction and frustration of developers while boosting productivity.
+
+This platform is driven by a centralized software catalog, providing efficiency to your microservices and infrastructure.
+
+Use {product} to simplify decision-making through a selection of internally approved tools, programming languages, and developer resources within a self-managed portal.
+
+
+include::modules/discover/con-benefits-of-rhdh.adoc[leveloffset=+1]

assemblies/assembly-add-custom-app-file-openshift.adoc

@@ -3,7 +3,7 @@
 
 To access the {product}, you must add a custom application configuration file to {ocp-brand-name}. In {ocp-short}, you can use the following content as a base template to create a ConfigMap named `app-config-rhdh`:
 
-[source,yaml]
+[source,yaml,subs="attributes+"]
 ----
 kind: ConfigMap
 apiVersion: v1
@@ -18,7 +18,7 @@ data:
 You can add the custom application configuration file to {ocp-short} in one of the following ways:
 
 * The {product} Operator
-* The {product} Helm chart.
+* The {product} Helm chart
 
 include::modules/getting-started/proc-add-custom-app-file-openshift-helm.adoc[leveloffset=+1]
 

assemblies/assembly-admin-templates.adoc

@@ -22,5 +22,4 @@ include::modules/templates/proc-adding-templates.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* link:{LinkGettingStartedGuide}[Configuring a GitHub App in {product-short}]
-* link:{LinkGettingStartedGuide}[Enabling the GitLab OAuth authentication provider]
+* link:{authentication-book-url}#assembly-auth-provider-github[Enabling the GitHub authentication provider]