Manual cherrypick (#1419)

Author: pabel-rh

modules/developer-lightspeed/proc-changing-your-llm-provider.adoc

@@ -16,20 +16,35 @@ The LLM provider configuration section includes a mandatory dummy provider block
 
 .Procedure
 
-You can define additional LLM providers using one of two methods.
+You can define additional LLM providers using either of following methods:
 
-* Recommended: In your Developer Lightspeed plugin configuration (For example, the `lightspeed` section within the `lightspeed-app-config.yaml` file), define the new provider or providers under the `lightspeed.servers` key as shown in the following code:
+* Recommended: In your Developer Lightspeed plugin configuration (the `lightspeed` section within the `lightspeed-app-config.yaml` file), define the new provider or providers under the `lightspeed.servers` key as shown in the following code:
 +
 [source,yaml]
 ----
 lightspeed:
   servers:
-    - id: my-new-provider
-      url: my-new-url
-      token: my-new-token
+    - id: _<my_new_provider>_
+      url: _<my_new_url>_
+      token: _<my_new_token>_
+----
++
+[NOTE]
+====
+In Developer preview, only one LLM server is supported at a time.
+====
+** Optional: You can set the `id`, `url`, and `token` values in a Kubernetes Secret and reference them as environment variables using the `envFrom` section.
+[source,yaml]
+----
+containers:
+    - name: my-container
+      image: my-image
+      envFrom:
+        - secretRef:
+            name: my-secret
 ----
 
-* Alternatively, you can add new LLM providers by updating the rcsconfig.yaml file.
+* You can add new LLM providers by updating the `rcsconfig.yaml` file.
 .. In the `llm_providers` section within your `rcsconfig.yaml` file, add your new provider configuration below the mandatory dummy provider block as shown in the following code:
 +
 [source,yaml]
@@ -42,9 +57,9 @@ llm_providers:
       models:
         - name: dummymodel
    # END: Do not remove this block
-    - name: my-new-providers
+    - name: _<my_new_providers>_
       type: openai
-      url: my-provider-url
+      url: _<my_provider_url>_
       credentials_path: path/to/token
       disable_model_check: true
 ----

modules/developer-lightspeed/proc-installing-and-configuring-lightspeed.adoc

@@ -72,7 +72,7 @@ data:
 +
 [IMPORTANT]
 ====
-Do not remove the block in the `llm_providers` section. This requirement is crucial when working with {ls-short} because of limitations discovered in Road Core. For instances where you decide to use an alternative LLM provider, you should refer to additional information in the guide. For more information, see link:{developer-lightspeed-link}#proc-changing-your-llm-provider[Changing your LLM provider].
+Do not remove the block in the `llm_providers` section. This requirement is crucial when working with {ls-short} because of limitations discovered in Road Core. For instances where you decide to use an alternative LLM provider, you should refer to additional information in the guide. For more information, see {developer-lightspeed-link}#proc-changing-your-llm-provider_customizing-developer-lightspeed[Changing your LLM provider].
 ====
 .. Optional: Configure the number of workers that scale the REST API by specifying the following example to the `ols_config.max_workers` parameter in the {rcs-short} ConfigMap.
 +