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!
Thanks! I'm aware of that repo. I think the problem is much deeper than can be fixed by creating more issues in the repo. The docs for k8s really need to be approached holistically by a technical writer or someone else who works on it full time. What's there now, and the approach the project has taken towards docs thus far, has resulted in information that is inconsistent, not well organized, and not well maintained. I think comprehensive documentation should be considered a requirement for a release—just as important as the code or the test suite. Software is only useful if people can figure out how to use it, and it's very hard to do that when it's so difficult to find high quality information.
Disclosure: I work at Google on Kubernetes.