2018-02-17 20:20:41 +08:00
|
|
|
This directory contains "newsfragments" which are short files that contain a small **ReST**-formatted
|
2018-02-07 08:13:04 +08:00
|
|
|
text that will be added to the next ``CHANGELOG``.
|
|
|
|
|
|
|
|
The ``CHANGELOG`` will be read by users, so this description should be aimed to pytest users
|
|
|
|
instead of describing internal changes which are only relevant to the developers.
|
|
|
|
|
2018-05-18 16:19:46 +08:00
|
|
|
Make sure to use full sentences with correct case and punctuation, for example::
|
2018-02-17 20:20:41 +08:00
|
|
|
|
|
|
|
Fix issue with non-ascii messages from the ``warnings`` module.
|
2018-02-07 08:13:04 +08:00
|
|
|
|
|
|
|
Each file should be named like ``<ISSUE>.<TYPE>.rst``, where
|
|
|
|
``<ISSUE>`` is an issue number, and ``<TYPE>`` is one of:
|
|
|
|
|
|
|
|
* ``feature``: new user facing features, like new command-line options and new behavior.
|
|
|
|
* ``bugfix``: fixes a reported bug.
|
|
|
|
* ``doc``: documentation improvement, like rewording an entire session or adding missing docs.
|
2018-02-08 18:03:14 +08:00
|
|
|
* ``removal``: feature deprecation or removal.
|
|
|
|
* ``vendor``: changes in packages vendored in pytest.
|
2018-02-07 08:13:04 +08:00
|
|
|
* ``trivial``: fixing a small typo or internal change that might be noteworthy.
|
|
|
|
|
|
|
|
So for example: ``123.feature.rst``, ``456.bugfix.rst``.
|
|
|
|
|
|
|
|
If your PR fixes an issue, use that number here. If there is no issue,
|
|
|
|
then after you submit the PR and get the PR number you can add a
|
|
|
|
changelog using that instead.
|
|
|
|
|
|
|
|
If you are not sure what issue type to use, don't hesitate to ask in your PR.
|
|
|
|
|
2018-07-07 22:07:13 +08:00
|
|
|
``towncrier`` preserves multiple paragraphs and formatting (code blocks, lists, and so on), but for entries
|
|
|
|
other than ``features`` it is usually better to stick to a single paragraph to keep it concise. You can install
|
|
|
|
``towncrier`` and then run ``towncrier --draft``
|
2018-02-07 08:13:04 +08:00
|
|
|
if you want to get a preview of how your change will look in the final release notes.
|