Start making examples more visible.

api/krusty/doc.go

@@ -1,6 +1,11 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 
-// Package krusty holds a very high level API to kustomize.
-// The functions here should be similar to the CLI api.
+// Package krusty is intended as the entry point package
+// for those seeking to add kustomize ability to other
+// programs.
+//
+// To use, follow the example of the kustomize CLI's 'build'
+// command.  Also, see the high level tests in this package,
+// which serve a dual purpose as examples.
 package krusty