X-Git-Url: https://git.openssl.org/gitweb/?p=openssl.git;a=blobdiff_plain;f=CONTRIBUTING;h=c0eed39e34b2905eae449470123c84fffdcd1fee;hp=76548624dd7882ca83cedf59ae25df6ba0ed57a5;hb=871980a9ada476fa54cec2e5174aa916d09efd11;hpb=2876872ffe5dd53ec1c446656e924ff463e5d4bf

diff --git a/CONTRIBUTING b/CONTRIBUTING
index 76548624dd..c0eed39e34 100644
--- a/CONTRIBUTING
+++ b/CONTRIBUTING
@@ -53,3 +53,20 @@ guidelines:
     documentation. Please look at the "pod" files in doc/man[1357] for
     examples of our style. Run "make doc-nits" to make sure that your
     documentation changes are clean.
+
+    7.  For user visible changes (API changes, behaviour changes, ...),
+    consider adding a note in CHANGES.  This could be a summarising
+    description of the change, and could explain the grander details.
+    Have a look through existing entries for inspiration. 
+    Please note that this is NOT simply a copy of git-log oneliners.
+    Also note that security fixes get an entry in CHANGES.
+    This file helps users get more in depth information of what comes
+    with a specific release without having to sift through the higher
+    noise ratio in git-log.
+
+    8.  For larger or more important user visible changes, as well as
+    security fixes, please add a line in NEWS.  On exception, it might be
+    worth adding a multi-line entry (such as the entry that announces all
+    the types that became opaque with OpenSSL 1.1.0).
+    This file helps users get a very quick summary of what comes with a
+    specific release, to see if an upgrade is worth the effort.