summaryrefslogtreecommitdiff
path: root/newsfragments/README.md
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff.email>2022-02-07 06:56:10 +0100
committerJörg Frings-Fürst <debian@jff.email>2022-02-07 06:56:10 +0100
commit43f33c72804e63306580755049c09d5a81ad83e3 (patch)
tree805caeb00a832ed96a331907987d4e6a2056a391 /newsfragments/README.md
parent0f86c5490ea7c2218a4394bf4c21bf3f9267a47c (diff)
parent6427d36e269d8c14e6bc55373102a4ebc971ca38 (diff)
Merge branch 'release/debian/1.1.1-1'debian/1.1.1-1
Diffstat (limited to 'newsfragments/README.md')
-rw-r--r--newsfragments/README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/newsfragments/README.md b/newsfragments/README.md
new file mode 100644
index 0000000..1201054
--- /dev/null
+++ b/newsfragments/README.md
@@ -0,0 +1,20 @@
+This is the directory for release note fragments processed by
+[towncrier](https://github.com/twisted/towncrier).
+
+When making a user-visible change create a file in this directory and it will be automatically be
+included into the release note document when the next release is published.
+
+The file extension specifies the type of a change. The following are currently supported:
+
+ - .backend: a new feature or a bugfix for a backend.
+ - .frontend: a new feature or a bugfix for a backend.
+ - .security: a fix for security issue.
+ - .removal: a deprecation or removal of functionality.
+ - .misc: miscellaneous changes
+
+Please don't add links to the merge requests into the release notes. If it's not clear where
+the feature is coming from by looking into the git history (e.g. if a release note is being
+made after the MR has landed) then add link to the MR to the commit description.
+
+Please add links to fixed issues in Gitlab by using full URLs to them instead of Gitlab
+shorthand syntax.