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) * [confirmed](https://github.com/polybar/polybar/labels/confirmed)
* [good first issue](https://github.com/polybar/polybar/labels/good%20first%20issue) * [good first issue](https://github.com/polybar/polybar/labels/good%20first%20issue)
* [help wanted](https://github.com/polybar/polybar/labels/help%20wanted) * [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 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. 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 ### Changelog
If your PR introduces notable changes to polybar, please add them to the top of We use the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for
the `Unreleased` section in the `CHANGELOG.md` file at the root of this keeping track of changes in a release.
repository.
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 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 options, changes to the build, etc., but not, for example, code cleanup that
doesn't change polybar's behavior or minor documentation changes. doesn't change polybar's behavior or minor documentation changes.
One thing that also should not be added to the changelog are bugfixes for One thing that also should not be added to the changelog are bugfixes for
unreleased features. unreleased features.
Also add a reference to all issues that this PR addresses in parentheses behind An entry in the changelog should include a link to the issue(s) that the PR
the changelog entry: 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 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. changelog and we can determine whether it is a notable change when reviewing.