# Training 15 experience review

## What made us smile?

## What was confusing?

- Searching the documentation was a bit confusing:
  - "CICD" query directed to Spot documentation
  - "CI/CD" is mentioned both in the context of project builds and remote content (might be confusing for new users)
  - legacy Workflows documentation appears in search
- REDOCLY_AUTHORIZATION is not an environment variable, instead it is a secret, contrary to UI text.
![Screenshot 2024-08-08 at 11.57.53.png](/assets/screenshot-2024-08-08-at-11.57.53.b80473a8381973421f10236fa09e375f3535c1165fd899c394d5a978098e6db2.9c1bb791.png)
- In the `push.yaml` file:
  - `domain` should be optional
  - `organization` should be removed, as it is taken from the secret (secrets are unique per organization)
![Screenshot 2024-08-08 at 11.58.29.png](/assets/screenshot-2024-08-08-at-11.58.29.e8ac3ce32b4429fe6f14350bd7d1125d0ca61e009d34c08ca9875d698040e9d5.9c1bb791.png)
- A copy of `push.yaml` file should be sent to DB to validate the `push.yaml`file created by the user.
  - This mechanism should validate at least the mount path.
  - Connect CI/CD modal has should have a **Create connection**. button instead of **Copy**.
- External contributors are not able to see logs in GitHub - they have no way of telling what broke the build. 
There should be a way to expose build logs externally. And maybe we should fail GH action once build failed.
- Preview does not work, since it is automatically removed when the development branch merges into main. 
Users should be redirected to the production view. ![Screenshot 2024-08-08 at 11.34.56.png](/assets/screenshot-2024-08-08-at-11.34.56.8f7e09d0de96bb84b7d0687c59142b2e8edb449d069c50366ecc3352bb69fb7a.9c1bb791.png)
- ![Screenshot 2024-08-08 at 14.38.49.png](/assets/screenshot-2024-08-08-at-14.38.49.65aace5c3d8239845575986d5bd56a069e81b32eba6d775a42654d9f325e1279.9c1bb791.png)