CoreOS recently released coreos-kubernetes (blog post), which is a maintained set of guides and Vagrant examples for running single and multi-node Kubernetes clusters.

I wanted to start a discussion on how we (CoreOS) can best incorporate these guides into upstream Kubernetes. Brainstorming a few options to get the converstation started, from most to least ideal:

1. Within /docs/getting-started-guides/coreos/, link to the guides on coreos.com and explain options for platforms, etc.
2. Sync coreos-kubernetes guides into Kubernetes as they are updated. This means they get included in the release tarball and will appear on kubernetes.io (example).
3. Maintain the existing guides as is and additionally mention the new guides
4. Remove CoreOS guides completely from the getting started docs

Any other ideas or preferences?

cc CoreOS folks: @aaronlevy, @bcwaldon
cc past contributors to docs: @pires, @vallard