Updating links

Author: pabel-rh

artifacts/attributes.adoc

@@ -183,4 +183,6 @@
 :openshift-ai-connector-for-rhdh-title: Integrate {product} with {openshift-ai-connector-name} to leverage AI models
 
 :openshift-ai-connector-name: OpenShift AI Connector for {product}
-:openshift-ai-connector-name-short: OpenShift AI Connector for {product-very-short}
+: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

modules/openshift-ai-connector-for-rhdh/con-understand-how-ai-assets-map-to-rhdh-catalog.adoc

@@ -7,4 +7,4 @@ include::{docdir}/artifacts/snip-developer-preview-rhoai.adoc[]
 
 The {openshift-ai-connector-name} ({openshift-ai-connector-name-short}) serves as a crucial link, enabling the discovery and accessibility of AI assets managed within the {rhoai-brand-name} offering directly within your {product-very-short} instance.
 
-For more information on model registry components, see https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html/enabling_the_model_registry_component/overview-of-model-registries_model-registry-config[Overview of model registries and model catalog].
+For more information on model registry components, see {rhoai-docs-link}/enabling_the_model_registry_component/index#overview-of-model-registries_model-registry-config[Overview of model registries and model catalog].

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

@@ -19,7 +19,7 @@ If you upgraded to {rhoai-short} 2.25 from an earlier version, you must manually
 * 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.
 For best overall experience, {rhoai-short} 2.25 is recommended.
 
-For more details, see link:https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html-single/enabling_the_model_registry_component/index[Enabling the model registry component].
+For more details, see {rhoai-docs-link}/enabling_the_model_registry_component/index[Enabling the model registry component].
 
 .Procedure
 
@@ -124,7 +124,7 @@ subjects:
     kind: Group
     name: system:serviceaccounts:ai-rhdh
 ----
-** `RoleBinding` in the {rhoai-short} namespace to grant the {product-very-short} `ServiceAccount` read permissions to the Model Registry data (binding to `registry-user-modelregistry-public`).
+** `RoleBinding` in the {rhoai-short} namespace to grant the {product-very-short} `ServiceAccount` read permissions to the model registry data (binding to `registry-user-modelregistry-public`).
 +
 [source,yaml]
 ----

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

@@ -3,17 +3,17 @@
 [id="proc-troubleshooting-connector-functionality_{context}"]
 = Troubleshooting Connector functionality
 
-The connector system consists of the two dynamic plugins and the three Model Catalog Bridge sidecar containers. Generally speaking, the logs collected should be provided to {company-name} Support for analysis.
+The connector system consists of the two dynamic plugins and the three model catalog bridge sidecar containers. Generally speaking, the logs collected must be provided to {company-name} Support for analysis.
 
 The actual contents of the diagnostic data are not part of any product guaranteed specification, and can change at any time.
 
 == Checking Dynamic Plugins status
 
 Validate that the dynamic plugins have been successfully installed into your {product-very-short} project Pod by using the following command:
 +
-[source,bash]
+[source,bash,subs=+attributes]
 ----
-oc logs -c install-dynamic-plugins deployment/<your RHDH deployment>
+oc logs -c install-dynamic-plugins deployment/<your {product-very-short} deployment>
 ----
 
 The `install-dynamic-plugin` logs allow you to check the following installation logs for successful logs:
@@ -58,17 +58,17 @@ oc get configmap bac-import-model -o json | jq -r '.binaryData | to_entries[] |
 
 . Check Location Service API: Confirm the location service is providing data to the {product-very-short} Entity Provider.
 +
-[source,bash]
+[source,bash,subs=+attributes]
 ----
-oc rsh -c backstage-backend deployment/<your RHDH deployment>
+oc rsh -c backstage-backend deployment/<your {product-very-short} deployment>
 curl http://localhost:9090/list
 ----
 
 . Check Sidecar Container Logs:
 +
 [source,bash]
 ----
-oc logs -c rhoai-normalizer deployment/<your RHDH deployment>
-oc logs -c storage-rest deployment/<your RHDH deployment>
-oc logs -c location deployment/<your RHDH deployment>
+oc logs -c rhoai-normalizer deployment/<your {product-very-short} deployment>
+oc logs -c storage-rest deployment/<your {product-very-short} deployment>
+oc logs -c location deployment/<your {product-very-short} deployment>
 ----

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

@@ -3,7 +3,7 @@
 [id="ref-enrich-ai-model-metadata_{context}"]
 = Enrich AI model metadata for enhanced {product} experience
 
-While {rhoai-short} provides essential data, an AI platform engineer using {rhoai-short} can enrich the {backstage}/{product-very-short} experience by adding custom properties to the `ModelVersion` or `RegisteredModel` (or annotations to the `KServe InferenceService` if the model registry is not used) so that the {openshift-ai-connector-name} can add the information to the {product-very-short} entities it creates. For more details, see https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html/working_with_model_registries/working-with-model-registries_model-registry#editing-model-version-metadata-in-a-model-registry_model-registry[Editing model version metadata in a model registry].
+While {rhoai-short} provides essential data, an AI platform engineer using {rhoai-short} can enrich the {backstage}/{product-very-short} experience by adding custom properties to the `ModelVersion` or `RegisteredModel` (or annotations to the `KServe InferenceService` if the model registry is not used) so that the {openshift-ai-connector-name} can add the information to the {product-very-short} entities it creates. For more details, see {rhoai-docs-link}/working_with_model_registries/index#editing-model-version-metadata-in-a-model-registry_model-registry[Editing model version metadata in a model registry].
 
 |===
 |Property Key |Entity Field Populated |Description

modules/openshift-ai-connector-for-rhdh/ref-model-to-entity-mapping.adoc

@@ -11,7 +11,7 @@ This offering interfaces with the {openshift-ai-connector-name-short}, model cat
 |Model Server (InferenceService)
 |Component
 |`model-server`
-|Represents a running, accessible AI model endpoint. See https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html/configuring_your_model-serving_platform/index[Configuring your model-serving platform].
+|Represents a running, accessible AI model endpoint. See {rhoai-docs-link}/configuring_your_model-serving_platform/index[Configuring your model-serving platform].
 
 |AI Model (Model Registry Version)
 |Resource
@@ -26,7 +26,7 @@ This offering interfaces with the {openshift-ai-connector-name-short}, model cat
 |Model Cards
 |TechDocs
 |N/A
-|Model cards from the {rhoai-short} model catalog are associated with the Component and Resource entities. See https://docs.redhat.com/en/documentation/red_hat_openshift_ai_self-managed/2.25/html/working_with_the_model_catalog/registering-a-model-from-the-model-catalog_working-model-catalog[Registering a model from the model catalog].
+|Model cards from the {rhoai-short} model catalog are associated with the Component and Resource entities. See {rhoai-docs-link}/working_with_the_model_catalog/registering-a-model-from-the-model-catalog_working-model-catalog#registering-a-model-from-the-model-catalog_working-model-catalog[Registering a model from the model catalog].
 |===
 
 Once the {openshift-ai-connector-name-short} is installed and connected with {rhoai-short}, the transfer of information commences automatically.