Incorporated Gabe's comments

Author: pabel-rh

modules/openshift-ai-connector-for-rhdh/proc-setting-up-openshift-ai-connector-for-rhdh-with-rhoai.adoc

@@ -7,7 +7,7 @@ The installation of the {openshift-ai-connector-name} requires manual updates to
 
 .{rhoai-short} Prerequisites
 
-* To have Model Cards from the Model Catalog imported as Tech Docs, you must use {rhoai-short} version 2.25 or later, and the Model Catalog dashboard and a Model Registry need to be enabled (they are both off by default).
+* To have Model Cards from the Model Catalog imported as TechDocs, you must use {rhoai-short} version 2.25 or later, and the *Model Catalog* dashboard and a Model Registry need to be enabled (they are both disabled by default).
 * If you employed Model Catalog at earlier versions of {rhoai-short}, Tech Doc propagation does not work for any models you registered into the Model Registry while at those earlier versions; only models registered into Model Registry from a 2.25 (or later) Model Catalog have their Model Cards transferred to {product-very-short} as TechDocs.
 * For the rest of the features, version 2.20 or later suffices. Enabling Model Registry and its associated dashboard allows for a user experience that more directly allows for customizing AI Model metadata.
 
@@ -36,11 +36,14 @@ plugins:
     package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-catalog-techdoc-url-reader-backend:bs_1.42.5__0.3.0!red-hat-developer-hub-backstage-plugin-catalog-techdoc-url-reader-backend
 ----
 
-. Add Connector sidecar containers to the {product-very-short} Pod.
-The system relies on three sidecar containers (Model Catalog Bridge) running alongside the `backstage-backend` container. These sidecar containers must be added to your {product-very-short} deployment specification, referencing the `rhdh-rhoai-bridge-token` Secret:
-** `location`: Provides the REST API for RHDH plugins to fetch model metadata.
+. Add `Connector` sidecar containers to the {product-very-short} Pod.
+** If {product-very-short} was installed using the Operator, modify your {product-very-short} custom resource (CR) instance.
+** If {product-very-short} was installed using the Helm charts, modify the *Deployment* specification.
+
+. The system relies on three sidecar containers (Model Catalog Bridge) running alongside the `backstage-backend` container. Add these sidecar containers to your configuration referencing the `rhdh-rhoai-bridge-token` Secret:
+** `location`: Provides the REST API for {product-very-short} plugins to fetch model metadata.
 ** `storage-rest`: Maintains a cache of AI Model metadata in a ConfigMap called `bac-import-model`.
-** `rhoai-normalizer`: Acts as a Kubernetes controller and RHOAI client, normalizing RHOAI metadata for the connector. The following code block is an example:
+** `rhoai-normalizer`: Acts as a Kubernetes controller and {rhoai-short} client, normalizing {rhoai-short} metadata for the connector. The following code block is an example:
 +
 [source,yaml]
 ----

modules/openshift-ai-connector-for-rhdh/proc-troubleshooting-connector-functionality.adoc

@@ -42,6 +42,11 @@ To enable debug logging, set the `LOG_LEVEL` environment variable to `debug` on
 
 The Model Catalog Bridge sidecars manage the data fetching and storage:
 
+[IMPORTANT]
+====
+{openshift-ai-connector-name} collects feedback from users who engage with the feedback feature. If a user submits feedback, the feedback score (thumbs up or down), text feedback (if entered), the user query, and the LLM provider response are stored locally in the file system of the Pod. {company-name} does not have access to the collected feedback data.
+====
+
 . Check Cached Data (ConfigMap): The processed AI Model metadata is stored in a `ConfigMap`.
 +
 [source,bash]

modules/openshift-ai-connector-for-rhdh/ref-enrich-ai-model-metadata.adoc

@@ -18,7 +18,7 @@ While {rhoai-short} provides essential data, an AI platform engineer can enrich
 
 |`TechDocs`
 |TechDocs
-|URL pointing to a Git repository that follows {product-very-short} TechDocs conventions for the Model Card.
+|URL pointing to a Git repository that follows {product-very-short} TechDocs conventions for the Model Card. Use this setting only if the *Model Card to TechDocs* mapping is not active.
 
 |`Homepage URL`
 |Links