website icon indicating copy to clipboard operation
website copied to clipboard

[Docs Enhacement - New Feature]: Add better examples for Git Integration Screens for Self Hosted

Open mrzarquon opened this issue 3 years ago • 0 comments

Describe your feature request

There is no clear "what do I do next" after you get the self hosted installation complete from the KOTS admin panel.

You are instead sent to our git integration guide but it isn't clear what exactly you should do next, since they talk about self hosted versions of the scm providers, but there's no mention of self hosted gitpod. The steps are pretty simple also:

  • go to https://your-new-install
  • add integration following on screen instructions

(as a side note, there should be included a "getting prepared for gitpod" that along with ssl certificates and DNS, mentions the need for the oauth tokens for git providers with concrete examples for those also)

And if you installed gitpod properly these are the screens you'd see, and if you didn't you didn't install it properly:

Screen Shot 2022-07-29 at 17 38 29 Screen Shot 2022-07-29 at 17 38 33

User impact

In a situation where the installation isn't quite right, the users may think they have to add credentials via some other method, or generally feel lost. Since installing gitpod still isn't easy, it feels like the user has reached the summit only to realize there is more to go.

Additional context

No response

mrzarquon avatar Jul 29 '22 18:07 mrzarquon