Better documentation about k8s HOT 2 OPEN

My main confusion is/was around how the API worked. With your sample I was able to figure out the apis folder contains lots of the types that when they are pointers can be used as k8s.Resources.

It would be nice to document the api folder is where all the types live and is the crux to knowing how to get / update k8s.Resources. the README shows where corev1 is, but i'm not a k8s expert and core doesn't really mean anything to me, so I thought I could get everything there. Seems apps is where Deployments live. /shrug maybe I should have known that?

I don't fully understand what the apiVersions are in k8s still. so it depends on how easy you want beginners to use your API. I was hoping the API would abstract away a lot of the need to understand fine grain details of how k8s works internally, but maybe that's just a mis-guided approach.

Also thanks for your help. I was able to get scale / set image working.

from k8s.

To your specific question, you'd do something like:

var d appsv1.Deployment
if err := client.Get(ctx, "my-namespace", "my-deployment", &d); err != nil {
    // Handle error
}
d.Spec.Replicas = k8s.Int32(10)
if err := client.Update(ctx, d); err != nil {
    // Handle error
} 

I want this library to work with its less dependencies, but it seem very unfriendly for non experts of kubernetes now.

I can see how that might happen. Would adding API reference links help? For example:

https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.9/

Or some example of "how do I track down an object?" like mapping

apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: default-deny
spec:
  podSelector: {}
  policyTypes:
  - Ingress

to the associated godocs:

https://godoc.org/github.com/ericchiang/k8s/apis/networking/v1#NetworkPolicy

from k8s.