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

* Incorporated changes

* incorporated kashish's comment

* comments

Author: pabel-rh

artifacts/attributes.adoc

@@ -37,7 +37,7 @@
 :rhsso: RHSSO
 
 // RHTAP information
-:rhtap-version: 1.2
+:rhtap-version: 1.3
 :rhtap-brand-name: Red Hat Trusted Application Pipeline
 :rhtap-very-short: RHTAP
 

assemblies/assembly-about-rhdh.adoc

@@ -8,11 +8,11 @@ endif::[]
 ifdef::context[]
 [id="about-rhdh_{context}"]
 endif::[]
-= About {product} ({product-very-short})
+= About {product} 
 
 :context: about-rhdh
 
-{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.
+{product} ({product-very-short}) 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.
 
 == Why use {product}
 
@@ -28,6 +28,7 @@ endif::[]
 
 * *Scalable documentation:* Keep your code and documentation together in the same repository, so everything stays in sync without relying on separate systems.
 
+<<<<<<< HEAD
 include::modules/about/con_elevate-your-development-with-secure-templates.adoc[leveloffset=+1]
 
 == Supported Platforms
@@ -37,6 +38,12 @@ include::modules/about/con_elevate-your-development-with-secure-templates.adoc[l
 * {aks-brand-name}
 * {osd-short} on {gcp-brand-name}
 
+=======
+// Placeholder for Supported platform include file [https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/pull/661/files]
+
+include::modules/about/con_elevate-your-development-with-secure-templates.adoc[leveloffset=+1]
+
+>>>>>>> 75e8c3ef1 (RHIDP-4896 Determining the permission policy configuration source (#705))
 [role="_additional-resources"]
 == Next steps
 

modules/about/con_elevate-your-development-with-secure-templates.adoc

@@ -3,16 +3,9 @@
 [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. 
+Installing Red Hat Trusted Application Pipeline (RHTAP) enhances Red Hat Developer Hub (RHDH) by adding secure CI/CD capabilities that integrate advanced security measures into your development process from the start. While RHDH focuses on the inner loop (code, build, and test), RHTAP covers the outer loop by automating code scanning, image building, vulnerability scanning, and deployment. 
 
-* *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.
+RHTAP includes tools like Red Hat Trusted Artifact Signer (RHTAS) for code integrity, Red Hat Trusted Profile Analyzer (RHTPA) for automated Software build of Materials (SBOM) creation, and Red Hat Advanced Cluster Security (RHACS) for vulnerability scanning. 
 
-* *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.
+Together they provide an end-to-end solution that simplifies and secures your software development lifecycle.
 

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.