Training 15 experience review

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

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.
• 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)
• A copy of push.yaml file should be sent to DB to validate the push.yamlfile 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.
•