diff --git a/docs/v3.0.0.md b/docs/v3.0.0.md
index 76ed1bd17..18f7b2e91 100644
--- a/docs/v3.0.0.md
+++ b/docs/v3.0.0.md
@@ -1,12 +1,14 @@
 # kustomize 3.0.0
 
-This release is [v2.1.0](v2.1.0.md), with some
-post v2.1.0 bugs fixed and a `v3` in Go package
+This release is basically [v2.1.0](v2.1.0.md), with some
+post-v2.1.0 bugs fixed and a `v3` in Go package
 paths.
 
-The `v3` puts plugin developers (both _Go_ plugin
+The major version increment to `v3` begins a new API
+that puts plugin developers (both _Go_ plugin
 authors and _exec_ plugin authors who happen to
-use Go) on a solid footing.
+use Go) on a solid footing through the coming 
+series of minor releases and patches.
 
 
 ### Go Module implications