-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
37 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
Use `ruff <https://docs.astral.sh/ruff>`_ for linting and formatting the code. Remove redundant GitHub workflow in favour of pre-commit. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
This directory contains "news fragments" which are short files that contain a small **ReST**-formatted | ||
text that will be added to the next ``CHANGELOG``. | ||
|
||
The ``CHANGELOG`` will be read by **users**, so this description should be aimed to hyperspy users | ||
instead of describing internal changes which are only relevant to the developers. | ||
|
||
Each file should be named like ``<ISSUE>.<TYPE>.rst``, where | ||
``<ISSUE>`` is an issue number, and ``<TYPE>`` is one of: | ||
|
||
* ``new``: new user facing features, like new command-line options and new behavior. | ||
* ``bugfix``: fixes a bug. | ||
* ``doc``: documentation improvement, like rewording an entire session or adding missing docs. | ||
* ``deprecation``: feature deprecation. | ||
* ``enhancements``: improvement of existing functionality, usually without requiring user intervention. | ||
* ``api``: a change which may break an existing script, such as feature removal or behavior change. | ||
* ``maintenance``: a change related to the test suite, packaging, etc. | ||
|
||
So for example ``1412.new.rst`` or ``2773.bugfix.rst``. | ||
|
||
If your PR fixes an issue, use the number of the issue 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. | ||
|
||
``towncrier`` preserves multiple paragraphs and formatting (code blocks, lists, and so on), but for entries | ||
other than ``new`` it is usually better to stick to a single paragraph to keep it concise. For ``new``, | ||
it is recommended to add a hyperlink to the user guide. | ||
|
||
To make a draft of the changelog, run from the command line: | ||
|
||
.. code-block:: bash | ||
$ towncrier build --draft | ||
See https://github.com/twisted/towncrier for more details. |