RHIDP-4862 - Update Tech Radar to 1.0 (redhat-developer#708)

pabel-rh · gtrivedi88 · commit 342e40d7ff20 · 2024-11-26T22:00:25.000+05:30
* Incorporated changes

* incorporated kashish's comment

* comments
diff --git a/artifacts/attributes.adoc b/artifacts/attributes.adoc
@@ -36,6 +36,11 @@
 :rhsso-brand-name: Red Hat Single-Sign On
 :rhsso: RHSSO
 
+// RHTAP information
+:rhtap-version: 1.2
+:rhtap-brand-name: Red Hat Trusted Application Pipeline
+:rhtap-very-short: RHTAP
+
 // Partner Platforms
 :aws-brand-name: Amazon Web Services
 :aws-short: AWS
diff --git a/assemblies/assembly-about-rhdh.adoc b/assemblies/assembly-about-rhdh.adoc
@@ -8,15 +8,16 @@ endif::[]
 ifdef::context[]
 [id="about-rhdh_{context}"]
 endif::[]
-= About {product}
+= About {product} ({product-very-short})
 
 :context: about-rhdh
 
-{product} is a fully supported, open developer platform that reduces friction and frustration of developers while boosting productivity.
+{product} is all about making your development process smoother and more efficient. It unifies all the tools and resources your team needs into one platform, helping you collaborate better and get your applications from code to deployment faster.
 
-This platform is driven by a centralized software catalog, providing efficiency to your microservices and infrastructure.
+== Why use {product}?
 
-Use {product} to simplify decision-making through a selection of internally approved tools, programming languages, and developer resources within a self-managed portal.
+* *Boost developer productivity:* Say goodbye to common organizational hiccups. With clear guidelines and automated processes your team can focus on what they do best - writing great code.
 
+* *Unified dashboard:* Access everything in one place - from Git repositories and CI/CD pipelines to issue tracking, monitoring, and documentation. With over 150 plugins, it’s all curated to fit your company’s best practices.
 
 include::modules/about/con-benefits-of-rhdh.adoc[leveloffset=+1]
diff --git a/modules/about/con_elevate-your-development-with-secure-templates.adoc b/modules/about/con_elevate-your-development-with-secure-templates.adoc
@@ -0,0 +1,18 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="elevate-your-development-with-secure-templates_{context}"]
+= Elevate your development with secure templates
+
+If you have the {rhtap-brand-name} ({rhtap-very-short}) installed, {product} ({product-very-short}) becomes even more powerful. {rhtap-very-short} provides additional secure software templates that you can use right within {product-very-short}. These templates help you integrate advanced security measures into your development process seamlessly, without adding complexity. 
+
+* *Ready-to-use secure templates:* Jumpstart your projects with templates that incorporate industry-leading security practices. {rhtap-very-short} ensures that every line of code contributes to a fortress of security significantly enhancing early vulnerability detection and mitigation.
+
+* *Seamless integration:*  The secure templates from {rhtap-very-short} slide right into your existing workflows, so there’s no extra work for your team. By aligning with Supply-chain Levels for Software Artifacts (SLSA) Level 3 {rhtap-very-short}’s pioneering secure CI/CD framework upholds the highest standards in software development.
+
+* *Focus on innovation:* With security built into your templates, {rhtap-very-short} helps you adopt a DevSecOps culture. This allows your developers to concentrate on building great features without getting bogged down by security setups.
+
+{rhtap-very-short} integrates *Red Hat Trusted Artifact Signer (RHTAS)* for code integrity, *Red hat Trusted Profile Analyzer (RHTPA)* for automated SBOM creation, and *Red Hat Advanced Cluster Security (RHACS)* for proactive vulnerability scanning, to strengthen your security posture with advanced tools, offering a robust defense against security threats throughout the development lifecycle.
+
+== Transform your development process
+By bringing everything together in one place, {product} helps your team work more effectively and deliver better software. And if you are looking to add an extra layer of security the secure templates from {rhtap-brand-name} are there to enhance your workflow throughout the software development lifecycle.
+
diff --git a/modules/getting-started/proc-customize-rhdh-tech-radar-page.adoc b/modules/getting-started/proc-customize-rhdh-tech-radar-page.adoc
@@ -1,16 +1,8 @@
 [id='proc-customize-rhdh-tech-radar-page_{context}']
 = Customizing the Tech Radar page in {product}
 
-In {product}, the Tech Radar page is provided by the `tech-radar` dynamic plugin, which is disabled by default. For information about enabling dynamic plugins in {product} see link:{LinkPluginsGuide}[Configuring plugins in {product}].
-
-In {product}, you can configure Learning Paths by passing the data into the `app-config.yaml` file as a proxy. The base Tech Radar URL must include the `/developer-hub/tech-radar` proxy.
-
-[NOTE]
-====
-Due to the use of overlapping `pathRewrites` for both the `tech-radar` and `homepage` quick access proxies, you must create the `tech-radar` configuration (`^api/proxy/developer-hub/tech-radar`) before you create the `homepage` configuration (`^/api/proxy/developer-hub`).
-
-For more information about customizing the Home page in {product}, see xref:proc-customize-rhdh-homepage_rhdh-getting-started[Customizing the Home page in {product}].
-====
+In {product}, the Tech Radar page is provided by the `tech-radar` and `tech-radar-backend` dynamic plugins, which are disabled by default. 
+For information about enabling dynamic plugins in {product} see link:{LinkPluginsGuide}[Configuring plugins in {product}].
 
 You can provide data to the Tech Radar page from the following sources:
 
@@ -21,33 +13,22 @@ You can provide data to the Tech Radar page from the following sources:
 
 .Prerequisites
 
-You have installed {product} by using either the Operator or Helm chart.
-For more information, see xref:{installing-on-ocp-book-url}#assembly-install-rhdh-ocp[{installing-on-ocp-book-title}].
+* You have installed {product} by using either the Operator or Helm chart. For more information, see link:{installing-on-ocp-book-url}[{installing-on-ocp-book-title}].
+* You have specified the data sources for the Tech Radar plugin in the `integrations` section of the `app-config.yaml` file. For example, to configure GitHub as an authentication provider, see link:{authentication-book-url}#authenticating-with-github[Authenticating with GitHub].
 
 .Procedure
 
 To access the data from the JSON files, complete the following step:
 
-* Add the following code to the `app-config.yaml` file:
+. Enable the `./dynamic-plugins/dist/backstage-community-plugin-tech-radar` and `/dynamic-plugins/dist/backstage-community-plugin-tech-radar-backend-dynamic` plugins.
+. Add the following code to the `app-config.yaml` file:
 +
 [source,yaml]
 ----
-proxy:
-  endpoints:
-    # Other Proxies
-    # customize developer hub instance
-    '/developer-hub':
-      target: <DOMAIN_URL> # i.e https://raw.githubusercontent.com/
-      pathRewrite:
-        '^/api/proxy/developer-hub/tech-radar': <path to json file> # i.e /janus-idp/backstage-showcase/main/packages/app/public/tech-radar/data-default.json
-	 '^/api/proxy/developer-hub': <path to json file> # i.e /janus-idp/backstage-showcase/main/packages/app/public/homepage/data.json
-      changeOrigin: true
-      secure: true
-
-      # Change to "false" in case of using self hosted cluster with a self-signed certificate
-      headers:
-	<HEADER_KEY>: <HEADER_VALUE> # optional and can be passed as needed i.e Authorization can be passed for private GitHub repo and PRIVATE-TOKEN can be passed for private GitLab repo
+techRadar:        
+    url: ${TECH_RADAR_DATA_URL} <1>
 ----
+<1>  `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded.
 
 == Using a dedicated service to provide data to the Tech Radar page
 
@@ -66,24 +47,20 @@ For more information, see xref:{installing-on-ocp-book-url}#assembly-install-rhd
 
 To use a separate service to provide the Tech Radar data, complete the following steps:
 
-. Add the following code to the `app-config-rhdh.yaml` file:
+. Add the dedicated service as an allowed host by adding the following code to the `app-config.yaml` file:
 +
 [source,yaml]
 ----
-proxy:
-  endpoints:
-    # Other Proxies
-    '/developer-hub/tech-radar':
-      target: ${TECHRADAR_DATA_URL}
-      changeOrigin: true
-      # Change to "false" in case of using self hosted cluster with a self-signed certificate
-      secure: true
+backend:    
+   reading:    
+        allow:     
+          - host: 'hostname'
 ----
-where the `TECHRADAR_DATA_URL` is defined as `pass:c[http://<SERVICE_NAME>/tech-radar]`, for example, `pass:c[http://rhdh-customization-provider/tech-radar]`.
-+
-[NOTE]
-====
-You can define the `TECHRADAR_DATA_URL` by adding it to `rhdh-secrets` or by directly replacing it with its value in your custom ConfigMap.
-====
+. Add the following to the `app-config.yaml` file:
 +
-. Delete the {product-short} pod to ensure that the new configurations are loaded correctly.
+[source,yaml]
+----
+techRadar:        
+    url: ${TECH_RADAR_DATA_URL} <1>
+----
+<1> `TECH_RADAR_DATA_URL` is the URL from which the JSON data is loaded.
