Rewrote how to choose a getting-started-guide. #11410
Conversation
|
GCE e2e build/test passed for commit 3ef2acef673059193552cac602fb26f6b1adb62f. |
|
@thockin @bgrant0607 @RichieEscarez @davidopp I rewrote docs/getting-started-guide/README.md. It still needs a pass of proofreading, but I thought I would get the general format out there for feedback. I've switched from having a table as the first thing you see to having prose that helps guide your decision of where to start. I left the table in at the bottom, but I'm thinking of getting rid of it too in a follow-up PR. I've started replacing "getting started guide" with the word "solution". Here is why:
My thought in terms of a left-nav for kubernetes.io is: to have the following items somewhere on the left nav bar:
|
|
GCE e2e build/test passed for commit 81c71bee623dec236361f89fc1ea3b0589119858. |
|
Awesome! Thanks much. I think this will help a lot. |
bgrant0607
added
kind/documentation
|
cc @davidopp for merge |
|
GCE e2e build/test passed for commit 673fcde51f9024c7e67ab9b46ad1fe3b48248107. |
| a kubernetes cluster from scratch. | ||
|
|
||
| ### Local-machine Solutions | ||
| These local-machine solutions create a single cluster with one or more kubernetes nodes on a single |
There was a problem hiding this comment.
What does "These" refer to? Did you mean to point to a doc or docs here?
There was a problem hiding this comment.
If you were referring to the ones listed in the next paragraph, then get rid of "Other automated local-machine solutions are:" and just move the bullet list up to merge with this paragraph
|
I'll leave the ok-to-merge label but please fix the above |
|
LGTM will merge on green |
|
GCE e2e build/test passed for commit 54cee89. |
Rewrote how to choose a getting-started-guide.
| ### Local-machine Solutions | ||
| Local-machine solutions create a single cluster with one or more kubernetes nodes on a single | ||
| physical machine. Setup is completely automated and doesn't require a cloud provider account. | ||
| But their size and availability is limited to that of a single machine. |
There was a problem hiding this comment.
Change 'But' to "However, "
| #### Integrations | ||
| - [Kubernetes on Mesos](mesos.md) (Uses GCE) | ||
|
|
||
| ## Table of Solutions |
There was a problem hiding this comment.
Can we replace this with a link, move this "table of solutions" to its own document, and say something like:
"See all of the solutions in a table, ordered by last tested/supported product version."
|
Thanks Eric. Looks great! Ill update the site nav based on this structure. LGTM pending my comments. |
No description provided.