I often end up referring to the GoDoc and core code when the documentation is lacking. I wish the docs gave a deeper explanation of each component and the objec

I often end up referring to the GoDoc and core code when the documentation is lacking. I wish the docs gave a deeper explanation of each component and the object model. There are also places where the content is too specific and not generally applicable. For example, this addon example that assumes you're using the kube-up convenience script: http://kubernetes.io/docs/getting-started-guides/logging-elasticsearch/ http://kubernetes.io/docs/getting-started-guides/logging-ela... No explanation of what the magic flag actually does, just "set this and run kube-up". (the real explanation is "copy the appropriate specs to your cluster addon directory")