Skip to content
This repository has been archived by the owner on Jun 28, 2023. It is now read-only.

The Getting Started guide could more explicitly help users make decisions #912

Closed
zjs opened this issue Jul 1, 2021 · 4 comments
Closed
Assignees
Labels
kind/docs A change in documentation owner/docs Work executed by VMware documentation team
Milestone

Comments

@zjs
Copy link
Member

zjs commented Jul 1, 2021

Feedback

There are a few points in the Getting Started guide that require users to make a decision: do I want a managed cluster or a standalone cluster? do I want to use AWS, Docker, or vSphere?

Little guidance is provided to help users decide which path to go down.

Suggested Changes

Explicitly address these decision points in the documentation. Help users understand the trade-offs they should be considering.

I think this is a bit of a balancing act, since you don't want the Getting Started guide to be overly complex, but I think it's also an opportunity to teach users a little bit about the project (e.g., that TCE supports a variety of infrastructure platforms) and guide them to the option you think is the safest starting point for most users.

Environment Details

N/A

@zjs zjs added kind/feedback General feedback. Actionable items are converted to a different 'kind/*' triage/needs-triage Needs triage by TCE maintainers labels Jul 1, 2021
@stmcginnis stmcginnis added the owner/docs Work executed by VMware documentation team label Jul 1, 2021
@kcoriordan kcoriordan self-assigned this Jul 6, 2021
@kcoriordan
Copy link
Contributor

kcoriordan commented Aug 30, 2021

@qnetter - I expect this issue to be more or less duplicate with #1093

@kcoriordan
Copy link
Contributor

dup with, similar to #908, #1073

@joshrosso
Copy link
Contributor

I believe this is slightly different. When going through the getting started guide, a user should be given minimal context to know which "tab" to choose more-or-less.

@joshrosso joshrosso added kind/docs A change in documentation and removed kind/feedback General feedback. Actionable items are converted to a different 'kind/*' triage/needs-triage Needs triage by TCE maintainers labels Sep 12, 2021
@joshrosso joshrosso added this to the icebox milestone Sep 12, 2021
@dvonthenen
Copy link
Contributor

I believe this is resolved with the new doc structure. If there is additional asks, please re-open and/or file a new issue.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
kind/docs A change in documentation owner/docs Work executed by VMware documentation team
Projects
None yet
Development

No branches or pull requests

6 participants