Skip to content

Commit bbec0ef

Browse files
committed
docs: Add changelog update instructions to readme
1 parent 985acd7 commit bbec0ef

1 file changed

Lines changed: 28 additions & 1 deletion

File tree

README.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,36 @@ purposes only.
6262

6363
See [`packages/create-package/README.md`](packages/create-package/README.md).
6464

65+
### Updating changelogs
66+
67+
Each package in this repo has a file named `CHANGELOG.md` which is used to
68+
record consumer-facing changes that have been published over time. All
69+
changelogs follow the ["Keep a Changelog"](https://keepachangelog.com/)
70+
specification (enforced by `@metamask/auto-changelog`).
71+
72+
If a PR introduces a consumer-facing change to one or more packages, their changelogs must
73+
be updated. This is enforced by CI. When updating changelogs, keep the following in mind:
74+
75+
- Place new entries under the "Unreleased" section.
76+
- Place changes into categories. Consult the ["Keep a Changelog"](https://keepachangelog.com/en/1.1.0/#how) specification for the list.
77+
- Highlight breaking changes by prefixing them with `**BREAKING:**`.
78+
- Omit non-consumer facing changes from the changelog.
79+
- Do not simply reuse the commit message, but describe exact changes to the API or usable
80+
surface area of the project.
81+
- Use a list nested under a changelog entry to enumerate more details about a change if need be.
82+
- Include links (e.g. `#123) to the pull request(s) that introduced each change.
83+
- Combine like changes from multiple pull requests into a single changelog entry if necessary.
84+
- Split disparate changes from the same pull request into multiple entries if necessary.
85+
- Omit reverted changes from the changelog.
86+
- A changelog is not a git history; it is a summary of consumer-facing changes introduced by
87+
a particular release.
88+
89+
If your PR does not contain any consumer-facing changes, add the label `no-changelog`, and the
90+
changelog validation CI job will be skipped.
91+
6592
### Releasing
6693

67-
For information on creating releases, see the [MetaMask/core release documentation](https://github.com/MetaMask/core/blob/main/docs/contributing.md#releasing-changes).
94+
For information on creating releases, see the [MetaMask/core release documentation](https://github.com/MetaMask/core/blob/d6ce6e1c917b1a05356df365281a5db83f500210/docs/processes/releasing.md).
6895

6996
### Patches
7097

0 commit comments

Comments
 (0)