Merge branch 'main' into RHIDP-8196

Author: deerskindoll

artifacts/attributes.adoc

@@ -65,6 +65,7 @@
 :rhdeveloper-name: Red Hat Developer
 :rhel: Red Hat Enterprise Linux
 :rhoai-brand-name: Red Hat OpenShift AI
+:rhoai-short: RHOAI
 :rhoserverless-brand-name: Red Hat OpenShift Serverless
 :rhsso-brand-name: Red Hat Single-Sign On
 :rhsso: RHSSO
@@ -168,9 +169,19 @@
 :upgrading-book-title: Upgrading {product}
 :using-dynamic-plugins-book-link: {product-docs-link}/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index
 :using-dynamic-plugins-book-title: Using dynamic plugins
+:plugin-type-name: custom
+:plugin-type-name-uppercase: Custom
+
 
 :scorecard-plugin-book-link: {product-docs-link}/html-single/understand_and_visualize_red_hat_developer_hub_project_health_using_scorecards/index
 :scorecard-plugin-book-title: Understand and visualize {product} project health using Scorecards
 
 :model-context-protocol-link: {product-docs-link}/html-single/interacting_with_model_context_protocol_tools_for_red_hat_developer_hub/index
 :model-context-protocol-title: Interacting with Model Context Protocol tools for {product}
+
+:openshift-ai-connector-for-rhdh-link: {product-docs-link}/html-single/accelerate_ai_development_with_openshift_ai_connector_for_red_hat_developer_hub/index
+
+:openshift-ai-connector-name: OpenShift AI Connector for {product}
+:openshift-ai-connector-name-short: OpenShift AI Connector for {product-very-short}
+
+:rhoai-docs-link: link:https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html-single

artifacts/snip-developer-preview-rhoai.adoc

@@ -0,0 +1,6 @@
+[IMPORTANT]
+====
+This section describes Developer Preview features in the {openshift-ai-connector-name} plugin. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to functionality in advance of possible inclusion in a Red Hat product offering. Customers can use these features to test functionality and provide feedback during the development process. Developer Preview features might not have any documentation, are subject to change or removal at any time, and have received limited testing. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
+
+For more information about the support scope of Red Hat Developer Preview features, see https://access.redhat.com/support/offerings/devpreview/[Developer Preview Support Scope].
+====

assemblies/assembly-authentication-troubleshooting.adoc

@@ -0,0 +1,9 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="authentication-troubleshooting"]
+
+= Troubleshooting authentication issues
+
+Learn how to troubleshoot authentication issues.
+
+include::modules/authentication/proc-reducing-token-size.adoc[leveloffset=+1]

assemblies/assembly-customizing-the-homepage.adoc

@@ -4,24 +4,23 @@
 [id="{context}"]
 = Customizing the Home page
 
-When using the `app-config`, you can do the following:
+When using your {product-very-short} `{my-app-config-file}` file, you can do any of the following tasks:
 
 * Customize and extend the default Home page layout with additional cards that appear based on the plugins you have installed and enabled.
 * Change quick access links.
-* Add, reorganize, and remove the following available cards:
-+
-** Search bar
-** Quick access
-** Headline
-** Markdown
-** Placeholder
-** Catalog starred entities
-** Featured docs
+* Add, reorganize, and remove the available homepage cards.
+
+
+include::modules/customizing-the-home-page/con-rhdh-available-cards.adoc[leveloffset=+1]
+
 
 include::modules/customizing-the-home-page/proc-customizing-the-home-page-cards.adoc[leveloffset=+1]
 
 
 include::modules/customizing-the-home-page/proc-defining-the-layout-of-the-product-home-page.adoc[leveloffset=+1]
 
 
-include::modules/customizing-the-home-page/proc-customizing-the-home-page.adoc[leveloffset=+1]
+include::modules/customizing-the-home-page/proc-customizing-the-home-page.adoc[leveloffset=+1]
+
+
+include::modules/customizing-the-home-page/proc-customizing-quickaccess-card-icons-on-the-rhdh-homepage.adoc[leveloffset=+1]

assemblies/assembly-enabling-authentication.adoc

@@ -18,3 +18,5 @@ include::assembly-enabling-authentication-with-github.adoc[leveloffset=+1]
 
 include::modules/authentication/proc-enabling-user-authentication-with-microsoft-azure-with-optional-steps.adoc[leveloffset=+1]
 
+include::assembly-authentication-troubleshooting.adoc[leveloffset=+1]
+

assemblies/assembly-install-rhdh-orchestrator-plugin-in-an-air-gapped-environment-helm.adoc

@@ -0,0 +1,10 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-install-rhdh-orchestrator-plugin-in-an-air-gapped-environment-helm_{context}"]
+= Installing Orchestrator plugin in an air-gapped environment with the Helm chart
+
+You can configure {product} ({product-very-short}) with the Orchestrator plugin in a fully disconnected or partially disconnected environment by using the Helm chart.
+
+include::modules/orchestrator/proc-install-rhdh-orchestrator-airgapped-env-using-helm-chart-full.adoc[leveloffset=+1]
+
+include::modules/orchestrator/proc-install-rhdh-orchestrator-airgapped-env-using-helm-chart-partial.adoc[leveloffset=+1]

assemblies/assembly-install-rhdh-orchestrator-plugin-in-an-air-gapped-environment-operator.adoc

@@ -0,0 +1,10 @@
+:_mod-docs-content-type: ASSEMBLY
+
+[id="assembly-install-rhdh-orchestrator-plugin-in-an-air-gapped-environment-operator_{context}"]
+= Installing Orchestrator plugin in an air-gapped environment with the Operator
+
+You can configure {product} ({product-very-short}) with the Orchestrator plugin in a fully disconnected or partially disconnected environment by using the Operator.
+
+include::modules/orchestrator/proc-install-rhdh-orchestrator-airgapped-env-using-operator-full.adoc[leveloffset=+1]
+
+include::modules/orchestrator/proc-install-rhdh-orchestrator-airgapped-env-using-operator-partial.adoc[leveloffset=+1]

assemblies/dynamic-plugins/assembly-converting-custom-plugin-to-dynamic-plugin.adoc

@@ -0,0 +1,24 @@
+:_mod-docs-content-type: ASSEMBLY
+
+= Extending {product} with custom plugins
+
+You can extend {product} with your own custom plugins. However, to add a custom plugin to the {product} pre-built container image, you must bundle and install your custom plugin as a dynamic plugin.
+
+To integrate a custom plugin into {product-short}, complete the following steps:
+
+. First, obtain the plugin's source code.
+. Export the plugin as a dynamic plugin package.
+. Package and publish the dynamic plugin.
+. Install the plugin in the {product-short} environment.
+
+[NOTE]
+====
+Standard {product-custom-resource-type} deployments statically compile plugins into the application itself. {product} supports dynamic plugins, meaning you can add plugins to an existing instance without recompiling the underlying {product-custom-resource-type} application.
+====
+
+include::../modules/dynamic-plugins/con-custom-plugin-conversion.adoc[leveloffset=+1]
+
+include::../modules/dynamic-plugins/proc-custom-plugin-conversion.adoc[leveloffset=+1]
+
+include::../modules/dynamic-plugins/con-custom-plugin-add-to-rhdh.adoc[leveloffset=+1]
+

assemblies/dynamic-plugins/assembly-install-third-party-plugins-rhdh.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: ASSEMBLY
 
 [id="assembly-install-third-party-plugins-rhdh"]
-= Installing third-party plugins in {product}
+= Installing {plugin-type-name} plugins in {product}
 :context: assembly-install-third-party-plugins-rhdh
 
-You can install a third-party plugins in {product} without rebuilding the {product-very-short} application.
+You can install a {plugin-type-name} plugins in {product} without rebuilding the {product-very-short} application.
 
 The location of the `dynamic-plugin-config.yaml` file depends on the deployment method. For more details, refer to xref:proc-config-dynamic-plugins-rhdh-operator_rhdh-installing-rhdh-plugins[Installing dynamic plugins with the {product} Operator] and xref:con-install-dynamic-plugin-helm_rhdh-installing-rhdh-plugins[Installing dynamic plugins using the Helm chart].
 
@@ -30,5 +30,5 @@ include::../modules/dynamic-plugins/proc-load-plugin-tgz-file.adoc[leveloffset=+
 include::../modules/dynamic-plugins/proc-load-plugin-js-package.adoc[leveloffset=+2]
 
 //example third-party plugin installation
-include::../modules/dynamic-plugins/proc-example-third-party-plugin-installation.adoc[leveloffset=+2]
+//include::../modules/dynamic-plugins/proc-example-third-party-plugin-installation.adoc[leveloffset=+2]
 

assemblies/dynamic-plugins/assembly-package-publish-third-party-dynamic-plugin.adoc

@@ -1,10 +1,10 @@
 :_mod-docs-content-type: ASSEMBLY
 
 [id="assembly-package-publish-third-party-dynamic-plugin"]
-= Packaging and publishing third-party plugins as dynamic plugins
+= Packaging and publishing {plugin-type-name} plugins as dynamic plugins
 :context: assembly-package-publish-third-party-dynamic-plugin
 
-After xref:proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[exporting a third-party plugin], you can package the derived package into one of the following supported formats:
+After xref:proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[exporting a {plugin-type-name} plugin], you can package the derived package into one of the following supported formats:
 
 * Open Container Initiative (OCI) image (recommended)
 * TGZ file