Umbrella: UX and "getting started" experience improvements

[detiber]

/kind feature
/priority important-soon

The current getting started experience and general user UX is pretty hostile.

• Help reduce user confusion between bootstrapping the cluster-api components, cluster creation, and pivoting.
• Ensure prerequisites are clear and fully defined
• Documentation around how to configure cluster/machines
• Explain how to scale a cluster
• etc...

/assign @detiber @randomvariable

[rdodev]

• CLIs:
  • There are several places where things can go sideways and the user has no idea where to start looking for errors.
  • CLIs should try to provide feedback more actively
  • When not possible to provide real-time feedback, the CLIs should at the very least instruct the user for next steps/debugging (like kubeadm reset for instance)
  • CLIs should be more verbose by default
• Documentation:
  • Troubleshooting guide
  • Implicit requirements:
    • registry with push permissions
    • image must be public (or else how to pass credentials inside DIND)
• Pre-flight checks:
  • For every action that has potentially bad non-recoverable states we should try to verify that all critical parts work.

[ncdc]

/milestone Next

[ncdc]

I'd like to close this and replace it with as many individual issues as needed to cover the various UX and getting started issues. If we need a way to combine them, we could consider using a milestone or a GitHub project perhaps? What do y'all think?

[detiber]

+1 for github projects, I'd like to avoid overloading the use of milestones.

[fejta-bot]

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.

If this issue is safe to close now please do so with /close.

Send feedback to sig-testing, kubernetes/test-infra and/or fejta.
/lifecycle stale

[vincepri]

/remove-lifecycle stale

[chuckha]

Please break this down into smaller issues and close this issue when done

[randomvariable]

I think we should close this now that we have the quick start guide?

[vincepri]

/close

[k8s-ci-robot]

@vincepri: Closing this issue.

In response to this:

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.