kpt icon indicating copy to clipboard operation
kpt copied to clipboard

docs: create a human friendly home-page for kpt

Open kostis-codefresh opened this issue 3 years ago • 2 comments

Describe your problem

The current home-page for kpt has exactly 0 examples and doesn't explain what kpt is or why do I need it.

It instead forces me to sit down and watch an 11 minute video which assumes that all visitors like to watch videos (which could not be further from the truth)

The text above the video seems like marketing speak to me or something that I would put in a research paper. I am not really sure what exactly is "KRM-driven architecture". Is this defined somewhere? (Also related https://github.com/GoogleContainerTools/kpt/issues/3356)

kpt

It is ok if there is a video for additional information, but not as the sole source of information for a tool.

As a comparison I am attaching the homepage of kustomize that has an example right on the homepage. I can look at the example in 30 seconds and understand what the tool does instead of watching an 11 minute video.

kustomize

kostis-codefresh avatar Jul 15 '22 12:07 kostis-codefresh

Thanks. Split out replacing the video into a separate issue: #3376

bgrant0607 avatar Jul 15 '22 14:07 bgrant0607

KRM-driven infrastructure is infrastructure configured via the Kubernetes Resource Model, such as via https://github.com/GoogleCloudPlatform/k8s-config-connector or crossplane.io.

Filed a specific issue to define or remove it: #3377.

bgrant0607 avatar Jul 15 '22 15:07 bgrant0607