-
Notifications
You must be signed in to change notification settings - Fork 54
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add decision record about removing the CHANGELOG.md
- Loading branch information
1 parent
784bf0d
commit 9bf0bcd
Showing
1 changed file
with
30 additions
and
0 deletions.
There are no files selected for viewing
30 changes: 30 additions & 0 deletions
30
docs/development/decision-records/2023-07-06_removing_manual_changelog/README.md
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,30 @@ | ||
# Removal of manually curated CHANGELOG.md | ||
|
||
## Decision | ||
|
||
We will not maintain a manually curated `CHANGELOG.md` file anymore. Instead, we will rely on an automatically generated | ||
one. GitHub Releases offers that feature. | ||
|
||
## Rationale | ||
|
||
Manually curating a CHANGELOG.md is an arduous process, that does not offer any real value, rather, it introduces mostly | ||
problems. Chief amongst those are the fact that typically the curation happens shortly before the release, which | ||
increases pressure, and introduces the possibility that something is forgotten. Also, digging up the correct issue/PR | ||
numbers is a tedious process. | ||
|
||
Relying solely on GitHub Releases fixes all that, because it will generate a succinct changelog, complete with issue/PR | ||
number and contributor. | ||
|
||
We would lose the possibility to formulate "humanly readable" change log entries, but that is easily offset by the fact | ||
that we [use conventional commits](../2023-04-20_conventional_commits). | ||
|
||
Thus, the commit log should be easily digestible and understandable, assuming a frequent release cycle. | ||
|
||
## Approach | ||
|
||
First, we need to fix the release process. It seems that at the time of this writing, the release PR contains _all_ | ||
commits, instead of just the delta between `main` and the last release. | ||
|
||
This is also reflected in the automatically generated changelog, for | ||
example [0.5.0-rc5](https://github.com/eclipse-tractusx/tractusx-edc/releases/tag/0.5.0-rc5). Once that is fixed, we can | ||
delete the CHANGELOG.md file and [this GH action to update it (line 44)](../../../../.github/workflows/draft-new-release.yaml). |