diff --git a/docs/README.md b/docs/README.md
index 3beb48528..aba8e48c5 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -23,6 +23,8 @@ English | [简体中文](zh/README.md)
 
 ## Release notes
 
+ * [3.1](v3.1.0.md) - Late July 2019. Extended pathces and improved resource matching.
+
  * [3.0](v3.0.0.md) - Late June 2019.  Plugin developer release.
 
  * [2.1](v2.1.0.md) - 18 June 2019.  Plugins, ordered resources, etc.
diff --git a/docs/v3.1.0.md b/docs/v3.1.0.md
new file mode 100644
index 000000000..b4243d777
--- /dev/null
+++ b/docs/v3.1.0.md
@@ -0,0 +1,7 @@
+# kustomize 3.1.0
+
+
+## extended patches
+Since this version, Kustomize allows applying one patch to multiple resources. This works for both Stretegic Merge Patch and JSON Patch. Take a look at [patch multiple objects](../examples/patchMultipleObjects.md).
+
+## Improved Resource Matching
\ No newline at end of file