1
0
Fork 0
mirror of https://github.com/polybar/polybar.git synced 2024-11-25 13:55:47 -05:00

More precisely specify desired changelog format

This commit is contained in:
patrick96 2022-02-25 04:19:25 +01:00 committed by Patrick Ziegler
parent eb535998da
commit e30453da99

View file

@ -59,6 +59,7 @@ unless someone else has already claimed them:
* [confirmed](https://github.com/polybar/polybar/labels/confirmed)
* [good first issue](https://github.com/polybar/polybar/labels/good%20first%20issue)
* [help wanted](https://github.com/polybar/polybar/labels/help%20wanted)
* [hacktoberfest](https://github.com/polybar/polybar/labels/Hacktoberfest) (can also be worked on outside of October :wink:)
For anything else, it's a good idea to first comment under the issue to ask
whether it is something that can/should be worked on right now.
@ -104,22 +105,31 @@ and some things may be harder/impossible to test right now.
### Changelog
If your PR introduces notable changes to polybar, please add them to the top of
the `Unreleased` section in the `CHANGELOG.md` file at the root of this
repository.
We use the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for
keeping track of changes in a release.
If your PR introduces notable changes to polybar, please add them the correct
subsection in the `Unreleased` section in the `CHANGELOG.md` file at the root
of this repository.
Notable changes are any user-visible changes, like bug fixes, new config
options, changes to the build, etc., but not, for example, code cleanup that
doesn't change polybar's behavior or minor documentation changes.
One thing that also should not be added to the changelog are bugfixes for
unreleased features.
Also add a reference to all issues that this PR addresses in parentheses behind
the changelog entry:
An entry in the changelog should include a link to the issue(s) that the PR
addresses, to the PR itself, and to your username:
```
[`#1234`](https://github.com/polybar/polybar/issues/1234)
- A short description of the change
([`#XYZ`](https://github.com/polybar/polybar/issues/XYZ),
[`#UVW`](https://github.com/polybar/polybar/pull/UVW))
by [@yourname](https://github.com/yourname).
```
You will first need to open the PR before you can link to it though :wink:.
If you are unsure whether something is a notable change, just add it to the
changelog and we can determine whether it is a notable change when reviewing.