website

The docs in github/kubernetes/kubernetes.github.io are what is rendered. The documentation was broken apart at some point. 90% of the time (if not always) when I'm looking for a file mentioned in the actual website docs the link (if one exists) is to the kubernetes repo, not the kubernetes.io repo. Going to the location in the kubernetes repo just gives you a loop back to the website you were just viewing. If you've used k8s docs for any significant amount of time I can pretty much guarantee that you've encountered this. Here's an example; limit-example.yml which is mentioned over and over in the limitrange docs but the file is nowhere to be found; http://kubernetes.io/docs/admin/limitrange/ If you don't know about the kubernetes.io repo (which someone who has never gone through looking for missing docs will not know about) you'll think t

One of my huge headaches in working with Kubernetes daily over the last year is how the documentation is dispersed. The documentation on the site will point you to manfiests in github.com/kubernetes/ which just point you back to the documentation on www.kubernetes.io. If you don't know that https://github.com/kubernetes/kubernetes.github.io/tree/mast... exists you're in for a bad time.

We have a brand new repo for fixing these things - https://github.com/kubernetes/kubernetes.github.io - but that said, if you EVER run into something misleading, outdated or incomplete, please ping immediately! Disclosure: I work at Google on Kubernetes.

Great feedback! Both Kubernetes Anywhere (https://github.com/kubernetes/kubernetes-anywhere) and our documentation efforts (https://github.com/kubernetes/kubernetes.github.io) are very much in flight - and they're both coming by 1.4 (~90 days).