Skip to content

Commit bdc8149

Browse files
committed
chore: prepare release 0.8.0
1 parent e85194f commit bdc8149

7 files changed

+77
-84
lines changed

.changeset/added_dates_to_version_titles.md

-19
This file was deleted.

.changeset/added_support_for_changesets.md

-13
This file was deleted.

.changeset/changelog_entries_now_use_4th_level_headers_instead_of_bullets.md

-25
This file was deleted.

.changeset/remove_duplicate_version_from_github_release_name.md

-17
This file was deleted.

.changeset/report_files_to_be_added_to_git_in_dry_run.md

-9
This file was deleted.

CHANGELOG.md

+76
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,82 @@ All notable changes to this project will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
66

7+
## 0.8.0 (2023-06-19)
8+
9+
### Breaking Changes
10+
11+
#### Changelog entries now use 4th level headers instead of bullets
12+
13+
In order to support more detailed changelogs via [changesets](https://knope-dev.github.io/knope/config/step/PrepareRelease.html) (like the extra text you're seeing right now!) instead of each change entry being a single bullet under the appropriate category (e.g., `### Breaking Changes` above), it will be a fourth-level header (`####`). So, where _this_ changelog entry would have currently looked like this:
14+
15+
```markdown
16+
### Breaking Changes
17+
18+
- Changelog entries now use 4th level headers instead of bullets
19+
```
20+
21+
It now looks like what you're seeing:
22+
23+
```markdown
24+
### Breaking Changes
25+
26+
#### Changelog entries now use 4th level headers instead of bullets
27+
28+
... recursion omitted
29+
```
30+
31+
If a change note starts with `#### ` already (like in changesets), it will be left alone.
32+
33+
### Features
34+
35+
#### Move GitHub Release headers up a level (#467, #472)
36+
37+
#### Added dates to version titles
38+
39+
There are now release dates in both changelogs and version names on GitHub. This probably won't break your releases, but you will have a different format for release notes which could be jarring. The date is in the format `YYYY-MM-DD` and will always be based on UTC time (so if you do a release late at night on the east coast of the United States, the date will be the next day).
40+
41+
Previously, the changelog entry title would look like this:
42+
43+
```markdown
44+
## 1.0.0
45+
```
46+
47+
And now it will look like this:
48+
49+
```markdown
50+
## 1.0.0 (2023-06-10)
51+
```
52+
53+
#### Report files to be added to git in `--dry-run`
54+
55+
The [`PrepareRelease`](https://knope-dev.github.io/knope/config/step/PrepareRelease.html) adds modified files to Git. Now, when running with the `--dry-run` option, it will report which files would be added to Git (for easier debugging).
56+
57+
> Note: The default `knope release` workflow includes this [`PrepareRelease`] step.
58+
59+
#### Remove duplicate version from GitHub release name
60+
61+
Release notes in GitHub releases used to copy the entire section of the changelog, including the version number. Because the name of the release also includes the version, you'd see the version twice, like:
62+
63+
```markdown
64+
# 1.0.0
65+
66+
## 1.0.0
67+
68+
... notes here
69+
```
70+
71+
Now, that second `## 1.0.0` is omitted from the body of the release.
72+
73+
#### Added support for changesets
74+
75+
Leveraging the new [changesets crate](https://github.com/knope-dev/changesets), Knope now supports [changesets](https://github.com/changesets/changesets)! In short, you can run `knope document-change` (if using default workflows) or add the new [`CreateChangeFile`] step to a workflow to generate a new Markdown file in the `.changeset` directory. You can then fill in any additional details below the generated header in the generated Markdown file. The next time the `PrepareRelease` step runs (e.g., in the default `knope release` workflow), all change files will be consumed to help generate a new version and changelog (along with any conventional commits).
76+
77+
For additional details, see:
78+
79+
- [`PrepareRelease` step](https://knope-dev.github.io/knope/config/step/PrepareRelease.html)
80+
- [`CreateChangeFile` step](https://knope-dev.github.io/knope/config/step/CreateChangeFile.html)
81+
- [Packages (for how you can customize changelog sections)](https://knope-dev.github.io/knope/config/packages.html)
82+
783
## 0.7.4
884

985
### Features

Cargo.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[package]
22
name = "knope"
33
description = "A command line tool for automating common development tasks"
4-
version = "0.7.4"
4+
version = "0.8.0"
55
authors = ["Dylan Anthony <[email protected]>"]
66
edition = "2021"
77
license = "MIT"

0 commit comments

Comments
 (0)