Merge pull request #153 from hausdorff/delete-docs

Add help docs for `delete`

cmd/delete.go

@@ -76,4 +76,24 @@ var deleteCmd = &cobra.Command{
 
 		return c.Run(objs)
 	},
+	Long: `Delete Kubernetes resources from a cluster, as described in the local
+configuration.
+
+ksonnet applications are accepted, as well as normal JSON, YAML, and Jsonnet
+files.`,
+	Example: `  # Delete all resources described in a ksonnet application, from the 'dev'
+  # environment. Can be used in any subdirectory of the application.
+  ksonnet delete dev
+
+  # Delete resources described in a YAML file. Automatically picks up the
+  # cluster's location from '$KUBECONFIG'.
+  ksonnet delete -f ./pod.yaml
+
+  # Delete resources described in the JSON file from the 'dev' environment. Can
+  # be used in any subdirectory of the application.
+  ksonnet delete dev -f ./pod.json
+
+  # Delete resources described in a YAML file, and running in the cluster
+  # specified by the current context in specified kubeconfig file.
+  ksonnet delete --kubeconfig=./kubeconfig -f ./pod.yaml`,
 }