summaryrefslogtreecommitdiffstats
path: root/release_docs/NEWSLETTER.txt
diff options
context:
space:
mode:
authorDana Robinson <43805+derobins@users.noreply.github.com>2023-02-13 14:03:11 (GMT)
committerGitHub <noreply@github.com>2023-02-13 14:03:11 (GMT)
commit768575225ecfe81e8965c47369576c9befb9d4c1 (patch)
tree6bf82693dc0b4f8b8d72f94f6afea1fcc378f444 /release_docs/NEWSLETTER.txt
parentb5ddec4554731191f3a7f04c57c87dae61762e74 (diff)
downloadhdf5-768575225ecfe81e8965c47369576c9befb9d4c1.zip
hdf5-768575225ecfe81e8965c47369576c9befb9d4c1.tar.gz
hdf5-768575225ecfe81e8965c47369576c9befb9d4c1.tar.bz2
Update release_docs HISTORY scheme (#2443)
We will no longer maintain HISTORY files for other maintenance branches, so those have been removed. Adds a README.md explaining the purpose and procedures of HDF5 HISTORY. Also adds a newsletter template and updates the RELEASE.txt note part of CONTRIBUTING.md. Also cleans out RELEASE.txt post-HDF5-1.14.0
Diffstat (limited to 'release_docs/NEWSLETTER.txt')
-rw-r--r--release_docs/NEWSLETTER.txt25
1 files changed, 25 insertions, 0 deletions
diff --git a/release_docs/NEWSLETTER.txt b/release_docs/NEWSLETTER.txt
new file mode 100644
index 0000000..f03f710
--- /dev/null
+++ b/release_docs/NEWSLETTER.txt
@@ -0,0 +1,25 @@
+INTRODUCTION
+============
+
+This purpose of this document is to contain entries that can be used to quickly
+produce a release newsletter. When something is added to the library that is
+"newsletter worthy" (i.e., new feature, CVE fix, etc.) a summary note should
+be added here.
+
+The format should look like this:
+
+* SUMMARY OF NEWSLETTER-WORTHY THING
+
+ Here is where you describe the summary. Summarize the feature, fix, or
+ change in general language. Remember, RELEASE.txt is for communicating
+ technical specifics. Text entered here is more like advertising.
+
+ (GitHub #123, #125)
+
+The GitHub #s could be relevant issues or PRs. They will probably not appear
+in the final newsletter, but are so that the person writing the newsletter
+has easy access to context if they have questions.
+
+Every entry in RELEASE.txt does NOT require an entry here. The newsletter is
+for communicating major changes that are of interest to anyone. Minor bugfixes,
+memory leak fixes, etc. do not require entries.