Advertise struct pointer requirement for Create

Make it explicit in the function comments that the "obj" argument
of the Client interface's Create method must be a struct pointer,
because implementers will store in it the object returned by the
K8s API server.

Author: matteoolivi

pkg/client/interfaces.go

@@ -60,7 +60,8 @@ type Reader interface {
 
 // Writer knows how to create, delete, and update Kubernetes objects.
 type Writer interface {
-	// Create saves the object obj in the Kubernetes cluster.
+	// Create saves the object obj in the Kubernetes cluster. obj must be a
+	// struct pointer so that obj can be updated with the content returned by the Server.
 	Create(ctx context.Context, obj Object, opts ...CreateOption) error
 
 	// Delete deletes the given obj from Kubernetes cluster.