Description of problem:

In https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.7/html/interacting_with_red_hat_developer_lightspeed_for_red_hat_developer_hub/developer-lightspeed#con-rag-embeddings_developer-lightspeed

step 1.4.3 it says:

In the OpenShift Container Platform web console, go to Secrets.
Click Create > Key/value secret.
In the Create key/value secret page, select the YAML view option in Configure via, and add the following example:

but there is no "Configure via..." YAML View option. Instead, it should say to use the "Create -> From YAML" menu item. This may be because I am on OpenShift 4.17.

In step 2.3 the ConfigMap lightspeed-app-config has yaml indentation issues. Under backend, the csp and image-src properties are not aligned with backend property causing startup error:

Loading config from MergedConfigSource{FileConfigSource

Unknown macro: {path="/opt/app-root/src/app-config.yaml"}

, FileConfigSource

Unknown macro: {path="/opt/app-root/src/app-config.example.yaml"}

, FileConfigSource

Unknown macro: {path="/opt/app-root/src/app-config.example.production.yaml"}

, FileConfigSource

Unknown macro: {path="/opt/app-root/src/dynamic-plugins-root/app-config.dynamic-plugins.yaml"}

, FileConfigSource

Unknown macro: {path="/opt/app-root/src/default.app-config.yaml"}

, FileConfigSource

, EnvConfigSource{count=1}}
/opt/app-root/src/node_modules/yaml/dist/compose/composer.js:70
this.errors.push(new errors.YAMLParseError(pos, code, message));
^

YAMLParseError: All mapping items must start at the same column at line 4, column 1:

upgrade-insecure-requests: false
img-src:
^

In step 4: it asks me to update my "existing dynamic plugins ConfigMap". I installed RHDH via the Operator, and it created an Operator-controlled dynamic plugins configmap that is uneditable (the Operator overwrites it during reconciliation). I never created a custom ConfigMap so when I edited the out-of-the-box one it got overwritten (As expected). I recommend adding something to the prerequisites, such as:

• You are logged into your OpenShift Container Platform account.
• You have an RHDH instance installed either of the following ways (...)
• You have created a custom Dynamic Plugins ConfigMap for an Operator- or Helm-based installation (and link to https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.7/html/installing_and_viewing_plugins_in_red_hat_developer_hub/rhdh-installing-rhdh-plugins_title-plugins-rhdh-about )
   

  Prerequisites (if any, like setup, operators/versions):

Install RHDH via the Operator

Steps to Reproduce

Follow the docs for integrating Developer Lightspeed.

Actual results:

It fails and RHDH crashes.

Expected results:

It should work without errors.

Reproducibility (Always/Intermittent/Only Once):

Always

Build Details:

RHDH 1.8.0 RC1
OpenShift 4.17