summaryrefslogtreecommitdiff
path: root/newsfragments/README.md
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff.email>2022-02-01 15:24:35 +0100
committerJörg Frings-Fürst <debian@jff.email>2022-02-01 15:24:35 +0100
commit302276dc1b90cfc972fb726ca94a23b18f4b0088 (patch)
tree33d99da40fb5fa097fdab5584d7ed550d25a33bb /newsfragments/README.md
parent351b7328520c16730ceb46e5acae16038c42185e (diff)
New upstream version 1.1.1upstream/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.