about summary refs log tree commit diff
path: root/Etc
diff options
context:
space:
mode:
Diffstat (limited to 'Etc')
-rw-r--r--Etc/creating-a-release.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/Etc/creating-a-release.txt b/Etc/creating-a-release.txt
index 2445151f5..fd52da86a 100644
--- a/Etc/creating-a-release.txt
+++ b/Etc/creating-a-release.txt
@@ -11,6 +11,10 @@ To create a zsh release:
 	README
 	NEWS
 
+  README should document compatibility-breaking changes. Generally, NEWS should
+  document new features and major bug fixes (but not routine fixes or changes to
+  completion/contrib functions).
+
 - Commit those changes with an "unposted" ChangeLog entry.
 
 	git commit -am "Test release: 5.5.1-test-1." &&