fa389cb54c
|
||
|---|---|---|
| .. | ||
| .gitignore | ||
| 2942.removal.rst | ||
| 2943.bugfix.rst | ||
| 2944.misc.rst | ||
| 2945.doc.rst | ||
| 2946.bugfix.rst | ||
| 2950.misc.rst | ||
| 2952.bugfix.rst | ||
| 2952.misc.rst | ||
| 2954.misc.rst | ||
| 2985.removal.rst | ||
| 2986.feature.rst | ||
| 2987.removal.rst | ||
| 2988.removal.rst | ||
| 2989.removal.rst | ||
| 2990.removal.rst | ||
| 2996.feature.rst | ||
| 2998.removal.rst | ||
| 3000.feature.rst | ||
| 3002.feature.rst | ||
| 3014.bugfix.rst | ||
| 3019.dev.rst | ||
| 3021.dev.rst | ||
| 3022.dev.rst | ||
| 3023.dev.rst | ||
| 3024.dev.rst | ||
| 3025.bugfix.rst | ||
| 3026.dev.rst | ||
| 3028.dev.rst | ||
| 3029.dev.rst | ||
| 3030.removal.rst | ||
| 3032.bugfix.rst | ||
| 3034.dev.rst | ||
| 3037.dev.rst | ||
| 3040.dev.rst | ||
| 3042.bugfix.rst | ||
| 3046.dev.rst | ||
| 3048.dev.rst | ||
| 3049.feature.rst | ||
| 3069.feature.rst | ||
| 3071.dev.rst | ||
| 3083.feature.rst | ||
| 3088.feature.rst | ||
| 3121.dev.rst | ||
| 3123.feature.rst | ||
| 3126.dev.rst | ||
| 3134.dev.rst | ||
| 3135.dev.rst | ||
| 3137.misc.rst | ||
| 3138.dev.rst | ||
| 3139.feature.rst | ||
| 3139.removal.rst | ||
| 3140.feature.rst | ||
| 3140.removal.rst | ||
| 3145.feature.rst | ||
| 3149.removal.rst | ||
| 3152.dev.rst | ||
| 3153.feature.rst | ||
| 3158.dev.rst | ||
| 3159.dev.rst | ||
| 3160.dev.rst | ||
| 3162.dev.rst | ||
| README.md | ||
| validate_files.py | ||
README.md
This directory collects "newsfragments": short files that each contain a snippet of ReST-formatted text that will be added to the next release notes. This should be a description of aspects of the change (if any) that are relevant to users. It contrasts with the commit message and PR description, which are descriptions of the change relevant to people working on the code itself.
The pull request (PR) number should be included in the newsfragment file name. Each newsfragment file
should be named <PR_NUMBER>.<TYPE>.rst, where <TYPE> is one of:
feature- featuresbugfix- bugfixesdoc- documentationremoval- deprecations and removalsmisc- otherdev- internal development tasks
For example: 123.feature.rst, 456.bugfix.rst, 789.doc.rst.
There can be multiple newsfragment files of different types for the same PR
e.g. 123.feature.rst and 123.removal.rst.
Along with the required PR newsfragment file (enforced by a GitHub Action),
additional newsfragment files for issues linked to the PR can optionally be
included by following the same naming convention above, and
using <ISSUE_NUMBER> instead of <PR_NUMBER>.
Note that the towncrier tool will automatically
reflow your text, so don't try to do any fancy formatting. Run
towncrier --draft to preview what the release notes entry
will look like in the final release notes.