diff --git a/types/doc.go b/types/doc.go
new file mode 100644
index 000000000..51e53b2f3
--- /dev/null
+++ b/types/doc.go
@@ -0,0 +1,10 @@
+// Copyright 2019 The Kubernetes Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+// Package types holds the definition of the kustomization struct and
+// supporting structs.  It's the k8s API conformant object that describes
+// a set of generation and transformation operations to create and/or
+// modify k8s resources.
+// A kustomization file is a serialization of this struct.
+package types
+
diff --git a/types/fix.go b/types/fix.go
index 936ccc765..5710a971f 100644
--- a/types/fix.go
+++ b/types/fix.go
@@ -1,7 +1,6 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 
-// Package types holds struct definitions that should find a better home.
 package types
 
 import (
diff --git a/types/kustomization.go b/types/kustomization.go
index 0ec1c64a6..e98c8b5e1 100644
--- a/types/kustomization.go
+++ b/types/kustomization.go
@@ -1,7 +1,6 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 
-// Package types holds struct definitions that should find a better home.
 package types
 
 const (