Skip to content

Commit 748288e

Browse files
authored
docs: format CHANGELOG.md with prettier (#181)
1 parent 4379de7 commit 748288e

File tree

4 files changed

+36
-6
lines changed

4 files changed

+36
-6
lines changed

.github/workflows/build-test.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,10 +85,10 @@ jobs:
8585
- run: yarn lint
8686
- name: Validate RC changelog
8787
if: ${{ startsWith(github.head_ref, 'release/') }}
88-
run: yarn auto-changelog validate --rc
88+
run: yarn auto-changelog validate --rc --prettier
8989
- name: Validate changelog
9090
if: ${{ !startsWith(github.head_ref, 'release/') }}
91-
run: yarn auto-changelog validate
91+
run: yarn auto-changelog validate --prettier
9292
- name: Require clean working directory
9393
shell: bash
9494
run: |

CHANGELOG.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,90 @@
11
# Changelog
2+
23
All notable changes to this project will be documented in this file.
34

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

78
## [Unreleased]
9+
810
### Fixed
11+
912
- Improved error handling when opening browser fails due to System Events permissions or non-standard browser configurations ([#178](https://github.com/MetaMask/create-release-branch/pull/178))
1013
- Now provides clear manual URL instructions instead of failing with osascript errors
1114
- Handles both cases: when terminal lacks System Events permissions and when using alternative browsers like Brave
1215

1316
## [4.1.1]
17+
1418
### Fixed
19+
1520
- Ask users to include peer dependents of a major-bumped package in the release, even they've had no changes ([#173](https://github.com/MetaMask/create-release-branch/pull/173))
1621
- UI: Include all peer dependents of a major-bumped package as available packages to release, even if they've had no changes ([#173](https://github.com/MetaMask/create-release-branch/pull/173))
1722

1823
## [4.1.0]
24+
1925
### Added
26+
2027
- Add interactive web UI for selecting package versions to release ([#166](https://github.com/MetaMask/create-release-branch/pull/166))
2128
- Added `--interactive` (`-i`) flag to launch a web-based UI for easier version selection
2229
- Added `--port` option to configure the web server port (default: 3000)
2330

2431
### Changed
32+
2533
- Refine breaking change dependent detection to only consider peer dependencies ([#170](https://github.com/MetaMask/create-release-branch/pull/170))
2634
- This change supports our policy of requiring packages with breaking changes to be released alongside their dependents
2735
- Regular dependencies are no longer included in this check
2836
- Allow `npm:name@version` dependency redirections in manifest ([#158](https://github.com/MetaMask/create-release-branch/pull/158))
2937

3038
## [4.0.0]
39+
3140
### Changed
41+
3242
- **BREAKING:** Bump minimum Node.js version to `^18.18` ([#156](https://github.com/MetaMask/create-release-branch/pull/156))
3343
- **BREAKING:** Bump `@metamask/auto-changelog` to `^4.0.0` ([#156](https://github.com/MetaMask/create-release-branch/pull/156))
3444
- This requires `prettier@>=3.0.0`.
3545

3646
## [3.1.0]
47+
3748
### Changed
49+
3850
- Allow `npm:name@version` dependency redirections in manifest ([#158](https://github.com/MetaMask/create-release-branch/pull/158)) ([#159](https://github.com/MetaMask/create-release-branch/pull/159))
3951

4052
## [3.0.1]
53+
4154
### Changed
55+
4256
- Bump `@metamask/utils` to `^9.0.0` ([#150](https://github.com/MetaMask/create-release-branch/pull/150))
4357

4458
### Fixed
59+
4560
- Correct Yarn constraint violations and update Yarn lockfile at the end of the release process ([#145](https://github.com/MetaMask/create-release-branch/pull/145))
4661
- This was previously a required step after running `create-release-branch`.
4762

4863
### Security
64+
4965
- Enable MetaMask security code scanner ([#133](https://github.com/MetaMask/create-release-branch/pull/133))
5066

5167
## [3.0.0]
68+
5269
### Changed
70+
5371
- **BREAKING:** Format changelogs using Prettier ([#100](https://github.com/MetaMask/create-release-branch/pull/100))
5472
- This is a breaking change since it changes the default formatting of the changelog in new release PRs. If you have a package script that runs `auto-changelog validate`, or you're calling `auto-changelog validate` in CI, you'll now need to pass the `--prettier` flag (see [example](https://github.com/MetaMask/metamask-module-template/pull/219)).
5573

5674
### Fixed
75+
5776
- Restore support for monorepos that use `workspace:^` references for interdependencies ([#125](https://github.com/MetaMask/create-release-branch/pull/125))
5877

5978
## [2.0.1]
79+
6080
### Fixed
81+
6182
- Move `@metamask/auto-changelog` from `devDependencies` to `dependencies` and pin to ~3.3.0 ([#122](https://github.com/MetaMask/create-release-branch/pull/122))
6283

6384
## [2.0.0]
85+
6486
### Changed
87+
6588
- **BREAKING** Bump minimum Node version to 16 ([#114](https://github.com/MetaMask/create-release-branch/pull/114))
6689
- Reorder workflow to update changelogs first ([#109](https://github.com/MetaMask/create-release-branch/pull/109))
6790
- When you run this tool you can use the changelogs to decide which versions to include in your release.
@@ -70,22 +93,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7093
- Soft-enforce major-bumped packages to be released along with their dependents ([#101](https://github.com/MetaMask/create-release-branch/pull/101))
7194
- If a new major version of a package A is being included in the release, and there are is a package B which depends on A but which is not also being released at the same time, then the tool will produce an error. This is to ensure that if a consumer is upgrading package A in a project and they also need to upgrade package B for compatibility reasons, they can.
7295
- Soft-enforce dependents to be released along with their dependencies ([#102](https://github.com/MetaMask/create-release-branch/pull/102))
73-
- If package B depends on package A, and A has changed since its last release, and B is being included in the release but not A, then the tool will produce an error. This is to ensure that if B has been changed to rely on a new feature that was added to A, it doesn't break when it is used in a project (since that feature is present in development but has not been published).
96+
- If package B depends on package A, and A has changed since its last release, and B is being included in the release but not A, then the tool will produce an error. This is to ensure that if B has been changed to rely on a new feature that was added to A, it doesn't break when it is used in a project (since that feature is present in development but has not been published).
7497

7598
## [1.1.0]
99+
76100
### Added
101+
77102
- Add support for nested workspaces ([#84](https://github.com/MetaMask/create-release-branch/pull/84))
78103

79104
### Changed
105+
80106
- Add `.yml` extension to `RELEASE_SPEC` file ([#83](https://github.com/MetaMask/create-release-branch/pull/83))
81107

82108
## [1.0.1]
109+
83110
### Fixed
111+
84112
- Update changelogs correctly for monorepo packages ([#50](https://github.com/MetaMask/create-release-branch/pull/50))
85113
- The changelog update step was encountering an error when used for a monorepo package release that had already been released at least once. Related to this, the changelog was being updated with the wrong tag links. Both problems should now be resolved.
86114

87115
## [1.0.0]
116+
88117
### Added
118+
89119
- Initial release
90120
- In this first release, this tool only supports monorepos with an independent versioning scheme. We will add support for other kinds of projects in future releases.
91121
- You can learn more on how to use this tool by reading the [documentation](docs/).

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
This is an interactive command-line tool that automates steps involved in preparing a new release of a project. These steps include updating versions of one or more desired packages, adding a new section to the packages' changelogs to include changes since the previous release, and then creating a new branch from which a pull request can be submitted for review before the release goes live.
44

5-
> **Note**
5+
> **Note**
66
> At the moment, this tool only supports monorepos that use an independent versioning strategy. Support for other types of projects is planned in a future release.
77
88
## Installation
@@ -61,7 +61,7 @@ The project follows the same release process as the other libraries in the MetaM
6161
- Generally any changes that don't affect consumers of the package (e.g. lockfile changes or development environment changes) are omitted. Exceptions may be made for changes that might be of interest despite not having an effect upon the published package (e.g. major test improvements, security improvements, improved documentation, etc.).
6262
- Try to explain each change in terms that users of the package would understand (e.g. avoid referencing internal variables/concepts).
6363
- Consolidate related changes into one change entry if it makes it easier to explain.
64-
- Run `yarn auto-changelog validate --rc` to check that the changelog is correctly formatted.
64+
- Run `yarn auto-changelog validate --rc --prettier` to check that the changelog is correctly formatted.
6565

6666
5. Review and QA the release.
6767

docs/changelog.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ After running this tool, you'll want to follow a few steps:
1212
- **Consolidation.** A changelog entry represents a complete unit of work, and some work may be split across multiple commits. In this case, you can combine multiple entries together, listing multiple PRs instead of just one.
1313
- **Omission.** Some changes do not affect end users of the project (e.g. lockfile changes, development environment changes, etc.). In these cases, you may remove these entries entirely. Exceptions may be made for changes that might be of interest despite not having an effect upon the published package (e.g. major test improvements, security improvements, improved documentation, etc.).
1414

15-
3. Once you're made your edits, make sure to run `yarn auto-changelog validate --rc` to check that the changelog is correctly formatted.
15+
3. Once you're made your edits, make sure to run `yarn auto-changelog validate --rc --prettier` to check that the changelog is correctly formatted.

0 commit comments

Comments
 (0)